dan/skills
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
skills/docs/work/2026-01-25-skill-organization.md
dan b6b47f8b38 feat(deploy): rewrite deploy-skill.sh for ai-skills module workflow 
- Script now shows what to add to skill lists (no file copying)
- Supports --pi-only flag for extension-dependent skills
- Checks skills.nix registry
- Update work doc with completed phases

Also filed issue for direnv cleanup (skills-vpdp)
2026-01-25 12:31:17 -08:00

4.2 KiB
Raw Blame History

Work: Skill Organization Across Agents

Intent

Link to: docs/intent/2026-01-25-skill-organization.md

Approach

Link to: docs/approach/2026-01-25-skill-organization.md

Checklist

Phase 1: Consolidate to Dotfiles

  • W001: Inventory current skills across all locations

    • Verification: find ~/.codex/skills ~/.claude/skills ~/.pi/agent/skills -name "SKILL.md" 2>/dev/null | wc -l returns count

  • W002: Create ~/proj/dotfiles/skills/ directory structure

    • Verification: SKIP — using existing ai-skills module, skills sourced from this repo

  • W003: Create ~/proj/dotfiles/pi/skills/ for pi-only skills

    • Verification: SKIP — piSkills added to ai-skills module, ralph-work-loop in this repo

  • W004: Copy universal skills to dotfiles/skills/

    • Verification: SKIP — skills already in ~/proj/skills/skills/, ai-skills module deploys them

  • W005: Copy pi-only skills to dotfiles/pi/skills/

    • Verification: ls skills/ralph-work-loop/SKILL.md exists in this repo

  • W006: Create/update Nix module to deploy skills to all agent locations

    • Verification: Added piSkills option to modules/ai-skills.nix

  • W007: Update pi settings to use correct sources

    • Verification: cat ~/.pi/agent/settings.json | jq '.skills' shows correct flags

  • W008: Nix rebuild and verify skills appear in all locations

    • Verification: ls ~/.claude/skills ~/.codex/skills ~/.config/opencode/skills ~/.pi/agent/skills all populated

Phase 2: Clean Up Old Locations

  • W009: Remove manually-managed skills from ~/.codex/skills/ (Nix now manages)

    • Verification: Skills in ~/.codex/skills/ are all Nix symlinks ✓

  • W010: Remove manually-managed skills from ~/.pi/agent/skills/ (except pi-only)

    • Verification: Only ralph-work-loop in ~/.pi/agent/skills/ ✓

  • W011: Remove duplicate skills from project-local directories (talu, etc.)

    • Verification: talu skills are Nix-managed symlinks (via talu's flake), not manual copies — no action needed

Phase 3: Update deploy-skill.sh

  • W012: Update deploy-skill.sh to support --pi-only flag

    • Verification: ./bin/deploy-skill.sh --help shows --pi-only option ✓

  • W013: Update deploy-skill.sh to show correct dotfiles config

    • Verification: ./bin/deploy-skill.sh brave-search shows skill list additions needed ✓

  • W014: Test end-to-end: verify deployed skills work

    • Verification: ls ~/.claude/skills/intent/SKILL.md exists, pi loads skills correctly ✓

Verification Evidence

  • (2026-01-25) W001: Inventoried 4 locations, found existing ai-skills Nix module already handles deployment
  • (2026-01-25) W002-W005: SKIP — infrastructure already exists in this repo + ai-skills module
  • (2026-01-25) W006: Added piSkills option to modules/ai-skills.nix
  • (2026-01-25) Copied ralph-work-loop to skills/ directory
  • (2026-01-25) Updated skills.nix registry
  • (2026-01-25) Updated ~/proj/dotfiles/home/claude.nix with full skill lists + piSkills
  • (2026-01-25) Removed manual nix-review deployments from codex.nix, opencode.nix, gemini.nix (now managed by ai-skills)
  • (2026-01-25) W007: Added settings.json to ~/proj/dotfiles/home/pi.nix with skill source config
  • (2026-01-25) W008: Nix rebuild successful. All agent locations populated. Old IAW skills remain in ~/.pi/agent/skills/ (cleanup in Phase 2)
  • (2026-01-25) W009: ~/.codex/skills/ already Nix-managed (symlinks to store)
  • (2026-01-25) W010: Removed manual intent/approach/work from ~/.pi/agent/skills/, cleaned up .backup files
  • (2026-01-25) W011: talu's .claude/skills/ are Nix symlinks via talu's flake — collision warnings are expected, not a bug
  • (2026-01-25) W012-W013: Rewrote deploy-skill.sh — now shows skill list config instead of copying files
  • (2026-01-25) W014: Verified intent/approach/work in ~/.claude/skills/, ralph-work-loop in ~/.pi/agent/skills/

Notes

  • Universal skills: worklog, screenshot-latest, orch, playwright-visit, code-review, ops-review, nix-review, hq, niri-window-capture, intent, approach, work
  • Pi-only skills: ralph-work-loop
  • Need to check what's currently in each location before migrating