Skip to content

feat(skills): install fx/skills for Claude Code, Codex and pi - #11

Merged
fx merged 2 commits into
mainfrom
feat/agent-skills
Oct 19, 2026
Merged

fx merged 2 commits into
mainfrom
feat/agent-skills

Conversation

@fx

@fx fx commented Oct 19, 2026

Copy link
Copy Markdown
Owner

Adds run_after_update-agent-skills.sh.tmpl, which runs npx -y skills@1.7.2 add fx/skills --global --skill '*' --agent claude-code codex pi -y on every apply.

  • The CLI places everything itself: content in ~/.agents/skills (Codex and pi read it directly), a symlink per skill in ~/.claude/skills.
  • run_after_, not run_onchange_: the script doesn't change when fx/skills does. A no-op re-run takes ~1 s.
  • Coder: ~/.agents and $DOTFILES_SHARED_HOME/.agents both link to /shared/agents, so the store survives rebuilds and the CLI's relative links (../../.agents/skills/<name>) resolve whether ~/.claude is container-local or a copy in the shared home.
  • Never fails the apply; telemetry off; CLI version pinned.
  • test/verify-marketplace.sh now also checks ~/.claude/skills/dev/SKILL.md resolves.

Tested: a desktop run (15 Claude Code links, all resolve) and a simulated Coder layout — fresh start and repeat start, with ~/.claude copied into the shared home in between — 15/15 resolve both times.

Runs the skills CLI on every apply so fx/skills changes are picked up.
In Coder the store lives in /shared/agents, linked from both ~/.agents
and the shared home so the CLI's relative Claude Code links resolve.
Copilot AI lite review requested due to automatic review settings October 19, 2026 00:12

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The new installer script and verification/docs have a couple of correctness/robustness issues (shared-home .agents linking behavior and brittle skill verification) that should be fixed before approval.

3 open issues
What changed in this PR

Adds automated installation of fx/skills agent skills as part of the dotfiles apply flow, ensuring Claude Code/Codex/pi have consistent skill content and links (including Coder shared-home persistence considerations).

Changes:

  • Add a run_after_ chezmoi script to install fx/skills via a pinned skills CLI on every apply.
  • Extend marketplace verification to assert the Claude Code skills links resolve.
  • Document the agent-skills installation behavior and Coder persistence model in CLAUDE.md.
File Description
.chezmoiscripts/​run_after_update-agent-skills.sh.tmpl New run_after_ script that installs fx/skills for multiple agents and handles Coder shared persistence.
test/​verify-marketplace.sh Adds a verification check for resolved Claude Code skill links.
CLAUDE.md Documents the agent-skills install mechanism and shared-home behavior.

Review effort: Lite

Comment thread test/verify-marketplace.sh Resolved
Comment thread CLAUDE.md Resolved

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The new run_after_ script is not executable in the repo snapshot, so chezmoi will not run it and the feature won’t work as intended.

1 open issue
3 resolved since last review

Review effort: Lite

@fx
fx merged commit 4f2a105 into main Oct 19, 2026
4 checks passed
@fx
fx deleted the feat/agent-skills branch October 19, 2026 00:19
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.

2 participants