Claude-skill-registry discovering

Discovering Skill

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/discovering" ~/.claude/skills/majiayu000-claude-skill-registry-discovering && rm -rf "$T"
manifest: skills/data/discovering/SKILL.md
source content

Discovering Skill

Use when the what/why is unclear; output is a direction, not a solution.

When to Use vs Researching

What's unclear?
├── What/Why (goal, scope, requirements) → Discovering
└── How (technical approach, implementation) → Researching

When to Use

  • Idea is vague or underspecified
  • Multiple interpretations exist
  • Need to align on scope and goals
  • Stakeholders have different expectations

Skip if: request is clear and decision-ready (use researching skill instead).

Quick Reference

PhaseFocusOutput
ContextCode, docs, recent changesCurrent state
IntentPurpose, constraints, criteriaRequirements
Directions2-3 approaches + trade-offsRecommendation
ConfirmSign-offDiscovery brief

Core Rules

  • Gather project context first
  • One question at a time
  • Prefer multiple choice
  • High-level directions, not technical solutions

Flow

  1. Context — Check code, docs, recent changes

  2. Intent — Purpose, constraints, success criteria, scope

  3. Directions — 2-3 high-level approaches with trade-offs; recommend one

  4. Confirm & Output — Discovery brief:

    • Goal (1 sentence)
    • Non-goals
    • Direction/approach
    • Open questions (1-3 bullets)

Get sign-off before proceeding.

Common Mistakes

MistakeFix
Jumping to technical solutionsStay high-level; how comes later
Asking multiple questions at onceOne question, wait for answer
Skipping context gatheringAlways check existing code/docs first
No clear recommendationAlways pick one direction and explain why
Proceeding without sign-offGet explicit confirmation

After Discovery

  • Technical uncertainty? → Use researching skill
  • Direction clear? → Proceed to implementation