Skip to content

refactor(skill): align SKILL.md with sandover (405→131 lines)#2

Merged
jamestjat merged 1 commit intomainfrom
refactor/skill-sandover-align
Apr 5, 2026
Merged

refactor(skill): align SKILL.md with sandover (405→131 lines)#2
jamestjat merged 1 commit intomainfrom
refactor/skill-sandover-align

Conversation

@jamestjat
Copy link
Copy Markdown
Owner

Summary

  • Refactor .claude/skills/ergo/SKILL.md to mirror the sandover ergo-feature-planning skill structure while preserving jamestjat workflow conventions.
  • Cut 67% of the file (405 → 131 lines) by deferring CLI reference, shell compat, state machine tables, anti-patterns, and troubleshooting to ergo --help / ergo quickstart.
  • Keep three sections --help cannot teach: Agent rules (7-row table), Multi-agent coordination (single-source-of-truth, race-safe claiming, unique agent identity), Landing the plane (phrase-triggered wrap-up with mandatory git push).

Description optimization

Tuned the frontmatter description via a 20-query trigger benchmark (10 should-trigger multi-commit/coordination/.ergo/ cases, 10 near-miss should-not-trigger cases like Linear, Taskfile, GitHub Projects, Claude Code's native TaskCreate).

Description Accuracy Precision Recall
Lean (sandover-style) 65% 100% 30%
ALWAYS-leading (this PR) 100% 100% 100%

Benchmark ran 5 trials × 20 queries = 100 trials per candidate, on claude-opus-4-6. The ALWAYS-leading phrasing with explicit command keywords and exclusion list achieved perfect triggering without regressing on near-misses.

Test plan

  • Skill renders correctly with ergo CLI installed
  • Description triggers on all 10 should-trigger eval queries
  • Description does not trigger on any of 10 near-miss queries
  • Body content reads end-to-end as a planning guide, not a CLI manual

🤖 Generated with Claude Code

Cut CLI reference, shell compat table, state machine, anti-patterns, and
troubleshooting — all derivable from `ergo --help` / `ergo quickstart`.
Keep jamestjat-specific workflow: agent rules table, multi-agent
coordination, and "land the plane" protocol.

Tuned description via trigger eval: 100%/100%/100% accuracy/precision/recall
on 20-query benchmark × 5 runs, up from 65%/100%/30% on the lean
sandover-style description.
@jamestjat jamestjat merged commit aa7853a into main Apr 5, 2026
2 of 4 checks passed
@jamestjat jamestjat deleted the refactor/skill-sandover-align branch April 5, 2026 17:29
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