Agent skill
004-exploration-and-review-skills-sichengchen-esper-2
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/004-exploration-and-review-skills-sichengchen-esper-2
SKILL.md
Add esper:explore skill for pre-planning investigation
Context
The current esper workflow goes straight from idea to plan (/esper:plan or /esper:fix). There is no structured way to investigate feasibility, explore trade-offs, or brainstorm approaches before committing to a plan. The existing skills follow a consistent pattern: a skills/esper-<name>/SKILL.md file with frontmatter, steps, and tool usage instructions. There are currently 10 skill directories under skills/.
Exploration output will be saved to .esper/explorations/ — a new directory that does not yet exist.
Approach
-
Create
skills/esper-explore/SKILL.mdwith the following workflow:- Step 1: Check setup — run
esperkit config check, read.esper/CONSTITUTION.mdand the current phase file for context - Step 2: Interview — use
AskUserQuestionto understand what the user wants to explore (feature idea, architectural question, feasibility check). Ask whether they want codebase-aware exploration, open-ended brainstorming, or both - Step 3: Explore — for codebase-aware mode, use the Task tool with
subagent_type: "Explore"to search the codebase for relevant patterns, files, and constraints. For brainstorm mode, discuss trade-offs, alternatives, and approaches conversationally - Step 4: Summarize findings — synthesize exploration into a structured markdown document
- Step 5: Save — write the exploration doc to
.esper/explorations/NNN-slug.md(use a simple incrementing ID based on existing files). Print the path and suggest next steps:/esper:planto formalize,/esper:fixif it's a bug, or defer. Explorations are consumed during/esper:phase— the phase skill reads them, asks the user which ideas to include, and archives included explorations to.esper/explorations/archived/
- Step 1: Check setup — run
-
Create
lib/exploration.js— a module mirroringlib/plan.jsfor managing exploration files in.esper/explorations/. Commands:list— list all explorations (excludearchived/), with optional--format jsonnext-id— scan existing explorations and return the next available zero-padded IDarchive <filename>— move an exploration to.esper/explorations/archived/get <filename>— print frontmatter of a single exploration as JSON
-
Add
explorationsubcommand tobin/cli.js— routeesperkit exploration <list|next-id|archive|get>tolib/exploration.js, following the same pattern as theplansubcommand. -
Update
skills/esper-phase/SKILL.md— add Step 3b to read explorations before the interview usingesperkit exploration list, ask user which to include, and archive selected ones after phase is defined usingesperkit exploration archive. -
Update the explore skill's Step 5 to use
esperkit exploration next-idfor ID generation instead of manual file scanning.
Files to change
skills/esper-explore/SKILL.md(create — the skill definition)lib/exploration.js(create — exploration management module: list, next-id, archive, get)bin/cli.js(modify — addexplorationsubcommand routing)skills/esper-phase/SKILL.md(modify — add Step 3b usingesperkit exploration listandesperkit exploration archive)
Verification
- Run:
node --test test/ - Expected: existing tests still pass, plus new tests for
lib/exploration.js - Edge cases: empty explorations dir, archiving already-archived explorations, ID generation with gaps
Progress
- Created
skills/esper-explore/SKILL.mdwith 5-step workflow (check, interview, explore, summarize, save) - Created
lib/exploration.jswith list, next-id, get, archive commands - Added
explorationsubcommand tobin/cli.js - Updated
skills/esper-phase/SKILL.mdStep 3b to useesperkit exploration list/archive - Added 11 tests in
test/exploration.test.js— all pass - Modified: skills/esper-explore/SKILL.md, lib/exploration.js, bin/cli.js, skills/esper-phase/SKILL.md, test/exploration.test.js
- Verification: 64/64 tests pass
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?