How sammcj/agentic-coding works
This repository is a personal toolkit for agentic coding: portable skills and guidance, plus Claude Code hooks and Pi extensions/diagnostics. The central user workflow is selecting a skill to extend an agent’s capabilities; several skills also expose standalone validation, transformation, or generation tools. The map highlights sampled runtime branches and README-documented categories. Many skill implementations and root-level rules/templates are not in the supplied tree or excerpts, so those are represented only at the directory level.
Main entry points: Skills Composable skills · run_yue2.py YuE2 workflow · hooks Claude Code hooks · check_output.py Rewrite checker
Components 19
Agent skills
- Composable skills
Skills
Skill quality
- Skill validator
Skills/skill-creator-primer/scripts/validate_skill.py - Skill report
Skills/skill-creator-primer/scripts/render_report.py - Rewrite checker
Skills/rewrite-slop/scripts/check_output.py - Sentence checks
Skills/rewrite-slop/scripts/syntax.py - Rewrite report
Skills/rewrite-slop/scripts/render_report.py
Media workflows
- YuE2 workflow
Skills/yue2-music/scripts/run_yue2.py - ABC score tools
Skills/yue2-music/scripts/abc_tools.py - Media skills
Skills
Agent integrations
- Home Assistant tools
Skills/home-assistant/scripts - Claude Code hooks
Claude/hooks - Command approval
Claude/hooks/approve-compound-commands.go - Plugin cache repair
Claude/hooks/context-mode-cache-heal.mjs
Pi tools
- Pi extensions
Pi/extensions - File change tracking
Pi/extensions/filechanges/index.ts - Pi diagnostics
Pi/diagnostics - Request capture proxy
Pi/diagnostics/capture-proxy.mjs
Other components
- Agent user
- YuE2 inference
Connections 19
- Agent user → Composable skills: selects skills
README.md - Composable skills → Skill validator: includes validation
README.md - Composable skills → Rewrite checker: includes rewriting checks
README.md - Composable skills → YuE2 workflow: includes music generation
README.md - Composable skills → Home Assistant tools: includes integrations
README.md - Skill report → Skill validator: reads findings
Skills/skill-creator-primer/scripts/render_report.py - Rewrite checker → Sentence checks: imports checks
Skills/rewrite-slop/scripts/check_output.py - Rewrite report → Rewrite checker: reads findings
Skills/rewrite-slop/scripts/render_report.py - Rewrite report → Sentence checks: uses sentence checks
Skills/rewrite-slop/scripts/render_report.py - YuE2 workflow → ABC score tools: parses scores
Skills/yue2-music/scripts/run_yue2.py - YuE2 workflow → YuE2 inference: runs inference
- Agent user → Media skills: uses capabilities
README.md - Agent user → Claude Code hooks: configures agent tools
README.md - Claude Code hooks → Command approval: provides command approval
Claude/hooks/approve-compound-commands.go - Claude Code hooks → Plugin cache repair: provides cache repair
Claude/hooks/context-mode-cache-heal.mjs - Agent user → Pi extensions: extends Pi
- Pi extensions → File change tracking: includes tracking extension
Pi/extensions/filechanges/index.ts - Agent user → Pi diagnostics: uses diagnostics
- Pi diagnostics → Request capture proxy: includes request capture
Pi/diagnostics/capture-proxy.mjs