Skip to content

Add mojo-stdlib-contributing skill#3

Open
msaelices wants to merge 4 commits intomodular:mainfrom
msaelices:mojo-stdlib-contributing
Open

Add mojo-stdlib-contributing skill#3
msaelices wants to merge 4 commits intomodular:mainfrom
msaelices:mojo-stdlib-contributing

Conversation

@msaelices
Copy link

@msaelices msaelices commented Mar 22, 2026

Summary

Add a skill for contributing to the Mojo standard library, distilled from 30+ reviewed PRs. Covers:

  • Process (GitHub issues before new APIs, draft PRs, branch isolation)
  • Assertion semantics (assert_mode="safe" table)
  • Optimization verification with compile_info and benchmarks
  • Code design patterns (reuse primitives, lazy eval, move semantics)
  • Benchmark patterns (black_box/keep, setup outside hot loop)
  • Testing requirements (unicode, edge cases, hit/miss paths)
  • SIMD/memory safety (pointer validation, endianness)
  • Writable trait patterns (Some[Writer], FormatStruct)

Assisted-by: AI

Add a skill capturing patterns and pitfalls for contributing to the Mojo
standard library, distilled from 30+ reviewed PRs. Covers process,
assertion semantics, optimization verification with compile_info,
benchmarks, testing, SIMD safety, and Writable trait patterns.

Signed-off-by: Manuel Saelices <msaelices@gmail.com>
Maintainer review cycles are expensive. The skill should instruct
the agent to ask the human to review the diff, PR description, and
benchmarks before converting from draft to ready for review.

Signed-off-by: Manuel Saelices <msaelices@gmail.com>
- Use standard editorial comment template from other skills
- Add opening paragraph consistent with mojo-syntax/gpu-fundamentals
- Remove content duplicated from mojo-syntax (Writable basics,
  deprecated APIs, comptime vs @parameter, move semantics)
- Remove general git/build commands already in CLAUDE.md
- Consolidate compile_info section, cut niche bullets
- Merge changelog into process section
- Reorder: process, assertions, optimizations, design, benchmarks,
  testing, SIMD, writable
- Reduce from 169 to 111 lines (34% smaller)

Signed-off-by: Manuel Saelices <msaelices@gmail.com>
Signed-off-by: Manuel Saelices <msaelices@gmail.com>
@msaelices msaelices marked this pull request as ready for review March 23, 2026 23:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant