Skip to content

refactor(skills): migrate skills to agent-skills-nix#137

Merged
ryoppippi merged 2 commits intomainfrom
refactor/migrate-skills-to-agent-skills-nix
Feb 4, 2026
Merged

refactor(skills): migrate skills to agent-skills-nix#137
ryoppippi merged 2 commits intomainfrom
refactor/migrate-skills-to-agent-skills-nix

Conversation

@ryoppippi
Copy link
Copy Markdown
Contributor

@ryoppippi ryoppippi commented Feb 4, 2026

Summary

Migrate skills management from local .claude/skills/ directory to Nix-based management using agent-skills-nix.

What Changed

  • 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

Why

  • Centralise skills in StackOneHQ/skills repository for reuse across projects
  • Leverage Nix for reproducible, declarative skill installation
  • Skills are automatically installed as symlinks when entering nix develop

Summary 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

    • Stop tracking .claude/skills and .agents/skills; add both to .gitignore.
    • Configure flake to discover and allowlist just-commands and release-please; install via symlink-tree to both targets in devShell.
    • Update CLAUDE.md to document Nix-managed skills.
  • Dependencies

    • Add agent-skills-nix and StackOneHQ/skills as flake inputs.
    • Update flake.lock for new and bumped inputs.

Written for commit 85e3342. Summary will update on new commits.

- 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`.
Copilot AI review requested due to automatic review settings February 4, 2026 11:45
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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-nix and StackOneHQ/skills as flake inputs, wire up catalog/selection, and integrate agentLib.mkShellHook plus mkBundle into the devShell so .claude/skills is populated as a symlink-tree.
  • Adjust treefmt’s oxfmt configuration to pass --no-error-on-unmatched-pattern and simplify shell messages while keeping existing pre-commit and tooling behavior intact.
  • Document Nix-managed skills in CLAUDE.md, ignore .claude/skills in .gitignore, and remove the local release-please and just-commands SKILL 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.

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 6 files

Add .agents/skills as a target for agent-skills-nix alongside .claude/skills.
This directory is used by Codex and other coding agents.
@ryoppippi ryoppippi merged commit fc98e07 into main Feb 4, 2026
23 of 24 checks passed
@ryoppippi ryoppippi deleted the refactor/migrate-skills-to-agent-skills-nix branch February 4, 2026 11:57
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