Skip to content

docs(skills): cross-model project skills (.agents canonical + .claude wrappers), incl. g6-release - #231

Merged
mbreiser merged 1 commit into
mainfrom
docs/portable-g6-skills
Sep 28, 2026
Merged

mbreiser merged 1 commit into
mainfrom
docs/portable-g6-skills

Conversation

@mbreiser

Copy link
Copy Markdown
Contributor

Summary

Lands the portable-skills work from codex/portable-g6-skills (2026-07-13), rebased onto main:

  • The canonical, model-neutral skill bodies now live under .agents/skills/ and are used directly by Codex. .claude/skills/ keeps thin wrappers with identical name and description, so Claude's skill triggering is unchanged.
  • Four skills: g6-orientation, protocol-yaml, g6-pattern-maker (new, closes the draft for Create a reusable Codex skill for G6 pattern making #160) and g6-release.
  • Main's newer skill content is carried over, not lost. Since July, main added the release-tier rules to g6-orientation, new material to protocol-yaml, and the requires: / runtime_controls checks to the protocol validator. All of it moved into the canonical copies. The only differences from main's text are the branch's deliberate path and heading rewrites.
  • The old validator path still works. .claude/skills/protocol-yaml/bin/validate-protocol.mjs remains as a forwarding shim.
  • g6-release moved to the same layout. It was added on main after the branch was cut.
  • New contract test: tests/test-project-skills.js, added to pixi run test. It checks the canonical layout, the wrapper routing and metadata, both validator entry points, and pattern-maker generation on 2×10 / 3×10 / 4×10 arenas.
  • Docs: AGENTS.md (new), a Project Skills section in CLAUDE.md, and docs/development/project-skills.md.

Tier

docs/skills-only, the release-process exception. No served page changes: the files are skills, docs, one test and the pixi.toml test chain.

Release notes

None (no tool changes).

Test plan

  • pixi run test: full suite green, including the new contract test
  • Line-coverage check: every line of main's .claude/skills/{g6-orientation,protocol-yaml,g6-release}/SKILL.md is present in the canonical copy, apart from the intentional path and heading rewrites

🤖 Generated with Claude Code

Canonical, model-neutral skill bodies live under .agents/skills/ (used
directly by Codex); .claude/skills/ holds thin wrappers with identical
triggering metadata. Contract test: tests/test-project-skills.js (in
`pixi run test`).

Rebased onto main 2026-09-28: main's July-September additions to the
g6-orientation skill (release tiers), the protocol-yaml skill, and the
protocol validator (requires: / runtime_controls checks) were carried into
the canonical copies; the old validator path stays as a forwarding shim.
The g6-release skill (added on main) moved to the same layout and joined
the contract test.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mbreiser
mbreiser merged commit 782329d into main Sep 28, 2026
5 checks passed
@mbreiser
mbreiser deleted the docs/portable-g6-skills branch September 28, 2026 23:49
mbreiser added a commit that referenced this pull request Sep 29, 2026
main is now Studio v0.92 (release 2026-09-28) with release-time versioning,
the .agents/ canonical skills (#231) and the CI fix (#232):
- the footer stays at main's v0.92 and the release-notes file at main's;
  this PR's notes move to the PR body (the candidate build bumps + folds)
- the protocol-yaml skill and validator changes move to the canonical
  .agents/skills/protocol-yaml/ copies; .claude/ keeps main's wrapper/shim
- pixi.toml: test-controller-settings.js added to main's test chain
- "v0.88" labels in the docs/skill now read v0.93 (the release it ships in)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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