Skip to content

feat: make installed skills and AGENTS.md visible to Claude Code - #10

Merged
antomanc merged 1 commit into
mainfrom
feat/claude-code-skills
Oct 11, 2026
Merged

antomanc merged 1 commit into
mainfrom
feat/claude-code-skills

Conversation

@antomanc

Copy link
Copy Markdown
Owner

Projects set up by aginit installed skills only for Antigravity and Codex (.agents/skills/). Claude Code reads project skills only from .claude/skills/<name>/SKILL.md, so it saw none of them.

Changes

  • Skills: pass claude-code to npx skills add --agent. The Skills CLI links each skill from the single copy in .agents/skills/ into .claude/skills/.
  • Config: new optional agents.claudeCode flag, true in new configs. Configs without it load unchanged and count as enabled. Set it to false to opt out.
  • Instructions: write a one-line CLAUDE.md (@AGENTS.md) when none exists. Claude Code v2.1.277+ reads AGENTS.md natively, but only when there's no CLAUDE.md and not in every session. The import works everywhere and never loads AGENTS.md twice (docs). An existing CLAUDE.md is never modified.
  • Graft: graft init --agents antigravity agents claude wires Graft's in-repo Claude Code integration. --no-global still applies.
  • aginit update: links already-installed skills for Claude Code when they're missing, and adds the CLAUDE.md import, so legacy projects need no manual steps.
  • aginit doctor: reports skills missing from .claude/skills/ and a CLAUDE.md without the import, and lists claude-code among the agents.
  • ADR docs/adr/0002-claude-code-skills-and-instructions.md, README, CHANGELOG, version bump to 0.4.0.

Verification

  • pnpm check: typecheck, 112 tests (13 new in tests/claude-code.test.ts, including legacy config loading), build and audit all pass.
  • Fresh aginit new demo --preset cli: .claude/skills/wayfinder/SKILL.md exists, 29/29 skills linked, doctor is green. A headless claude -p session in the project loads the 14 model-invocable skills. The other 16, wayfinder among them, are disable-model-invocation: true, so they're user-only /name commands as expected.
  • A copy of ~/dev/personal-blog (legacy config): doctor flagged 31 unlinked skills, then aginit update linked all 31, added CLAUDE.md, and doctor went green.

Install skills for the claude-code agent too, so the Skills CLI links each
one into .claude/skills/. Write a CLAUDE.md importing AGENTS.md, wire Graft
for Claude Code, relink legacy projects on aginit update, and add doctor
checks. New agents.claudeCode flag defaults to enabled; legacy configs keep
loading. See docs/adr/0002.
@antomanc
antomanc merged commit 34f2c7d into main Oct 11, 2026
6 checks passed
@antomanc
antomanc deleted the feat/claude-code-skills branch October 11, 2026 11:20
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