Agent skill
phase-1-sichengchen-esper
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/phase-1-sichengchen-esper
SKILL.md
Add esper:done skill — finalize a plan with a guaranteed commit
Context
Currently the esper workflow has two commit-related commands:
/esper:commit— save partial progress anytime; only commits if there are changes/esper:ship— verify + commit + push + open PR + archive
There is no command that finalizes a plan (archives it to done/) without opening a PR. This gap matters most in type: "feature" plans, where per-plan PRs are skipped — the user needs a way to say "this plan is complete, commit my work and archive it" before moving on to the next plan. The phase PR is opened later by esper:ship when all phase plans are done.
The key difference from /esper:commit:
/esper:commit: partial save, can be called anytime, no-ops if nothing changed/esper:done: finalization step — always produces a commit (even if the only change is the plan file itself), then archives the plan todone/
Files changed
skills/esper-done/SKILL.md(created — the new skill)skills/esper-ship/SKILL.md(modified — Step 1: check done/ fallback; Step 6: handle already-archived plans)
Verification
- Run: manual
- Expected:
- Feature plan workflow: implement plan →
/esper:done→ plan is indone/withstatus: done,shipped_atset, noprfield; working tree committed → repeat for next plan →/esper:shipfinds done plans, opens phase PR, addspr:to each plan's frontmatter - Fix plan workflow: implement →
/esper:done→/esper:shipfinds the done plan, pushes, opens PR, updates plan frontmatter withpr:URL /esper:commitbehavior unchanged
- Feature plan workflow: implement plan →
Progress
- Created
skills/esper-done/SKILL.md: 5-step workflow — check setup → verify → commit (always, skip if clean) → archive to done/ (no pr field) → summary with type-aware next-step message - Updated
skills/esper-ship/SKILL.mdStep 1: checks done/ for unshipped plan (no pr field) if active/ is empty; updated Step 6: handles already-archived plans in done/ by only updating pr field instead of moving - Adapted plan to use
typefield instead of deprecatedpr_modereferences - Modified: skills/esper-done/SKILL.md (created), skills/esper-ship/SKILL.md
- Verification: manual — new skill visible via
node bin/cli.js
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?