advise

SKILL.md

/advise

Interactive, conversational guidance as you implement a task yourself.

Usage

/advise 001              # Guide through issue 001
/advise yourbench 001    # Explicit project
/advise 001 --phase 2.1  # Start at specific phase

Comparison: /implement vs /advise vs /teach

Aspect /implement /advise /teach
Who writes code AI You You
Speed Fast Medium Slower
Depth Task completion Task guidance Conceptual learning
Questions Few As needed Frequent, Socratic

What to Expect

Conversational Flow

AI: "First step: Initialize Next.js. The directory has some docs,
     so we'll move those temporarily..."

User: "What does the --no-git flag do?"

AI: "Good question! It tells create-next-app to skip running
     'git init' since you already have a repo..."

User: "Done"

AI: "Let me check... Looks good. Next, we need to clean up
     the boilerplate..."

Guidance Style

  • Explains WHAT to do - Clear instructions per step
  • Answers questions - Responds to clarifications
  • Checks your work - Reviews when you say "done"
  • Adapts pace - Moves forward when ready
  • Practical focus - Task-focused, not teaching concepts

Execution Flow

1. Load Context

Read: ideas/[project]/issues/###-*/TASK.md
Read: ideas/[project]/issues/###-*/PLAN.md
Read: ideas/[project]/specs/SPEC-###.md (if linked)
Glob: spaces/[project]/docs/project/adrs/ADR-*.md

2. Conversational Guidance

  1. Explain the current step simply
  2. Wait for user questions or confirmation
  3. Answer questions as they come up
  4. Check work when user says "done"
  5. Move to next step when ready

3. Research as Needed

  • Use Context7 for library docs
  • WebSearch for best practices
  • Reference codebase patterns

4. Check Work

When user says "done":

  • Read the modified file
  • Check for common mistakes
  • Verify it matches requirements
  • Suggest fixes if needed

5. Update WORKLOG

At checkpoints:

## YYYY-MM-DD HH:MM - ADVICE: Phase 1 Complete

Guided user through Next.js initialization.
Completed: ...
Next: Phase 2

When to Use

  • Know the stack, need guidance on THIS task
  • Want control but avoid mistakes
  • Prefer hands-on implementation
  • Task has complexity worth discussing

Use /implement instead: Just want it done quickly, boilerplate code Use /teach instead: Learning the technology, need conceptual understanding

Workflow

/issue -> /plan -> /advise -> [you implement] -> /worklog -> /commit
Weekly Installs
6
GitHub Stars
38
First Seen
Jan 26, 2026
Installed on
claude-code6
gemini-cli5
codex5
cursor5
opencode5
trae4