refactor(skills): migrate skills to agent-skills-nix#137
Merged
Conversation
- Remove local skills directory from git tracking - Add agent-skills-nix and StackOneHQ/skills as flake inputs - Configure devShell to auto-install skills via symlink-tree - Update .gitignore to exclude Nix-managed skill directories - Update CLAUDE.md to document the new skills management approach Skills are now sourced from StackOneHQ/skills repository and automatically installed when entering `nix develop`.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR migrates Claude skills management from in-repo .claude/skills files to a Nix-based setup using agent-skills-nix and the shared StackOneHQ/skills repository. It updates the Nix flake to automatically install skills as symlinks on nix develop, documents the new approach, and removes now-redundant local skill definitions.
Changes:
- Add
agent-skills-nixandStackOneHQ/skillsas flake inputs, wire up catalog/selection, and integrateagentLib.mkShellHookplusmkBundleinto thedevShellso.claude/skillsis populated as asymlink-tree. - Adjust
treefmt’soxfmtconfiguration to pass--no-error-on-unmatched-patternand simplify shell messages while keeping existing pre-commit and tooling behavior intact. - Document Nix-managed skills in
CLAUDE.md, ignore.claude/skillsin.gitignore, and remove the localrelease-pleaseandjust-commandsSKILL definitions in favor of the centralized skills repo.
Reviewed changes
Copilot reviewed 4 out of 6 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
flake.nix |
Adds agent-skills and stackone-skills inputs, builds a skills catalog/allowlist/selection, configures a bundle and local targets, and extends the devShell shellHook to install skills into .claude/skills as a symlink tree. |
flake.lock |
Pins agent-skills-nix, StackOneHQ/skills, and their transitive inputs (e.g. home-manager) and refreshes existing flake input revisions to align with the new configuration. |
CLAUDE.md |
Updates the description of .claude/skills to note Nix-based management via agent-skills-nix and StackOneHQ’s skills repo while keeping the skills tables consistent with the new source of truth. |
.gitignore |
Ignores .claude/skills so the Nix-managed symlink tree is not tracked in Git. |
.claude/skills/release-please/SKILL.md |
Removes the in-repo release-please skill definition, deferring to the shared skills repository. |
.claude/skills/just-commands/SKILL.md |
Removes the in-repo just-commands skill definition, also deferring to the shared skills repository. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Add .agents/skills as a target for agent-skills-nix alongside .claude/skills. This directory is used by Codex and other coding agents.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Migrate skills management from local
.claude/skills/directory to Nix-based management using agent-skills-nix.What Changed
agent-skills-nixandStackOneHQ/skillsas flake inputssymlink-tree.gitignoreto exclude Nix-managed skill directoriesCLAUDE.mdto document the new skills management approachWhy
nix developSummary by cubic
Migrated skills management from the local .claude/skills directory to agent-skills-nix, sourcing from StackOneHQ/skills and auto-installing symlinked skills to .claude/skills and .agents/skills on nix develop for Codex compatibility. This removes tracked skill files and makes setup reproducible.
Refactors
Dependencies
Written for commit 85e3342. Summary will update on new commits.