Skip to content

[feature-runner] Add Quick start section to SKILL.md #90

@orioltf

Description

@orioltf

This was generated by AI during triage.

Parent

docs/issues/feature-runner/PRD.md

What to build

Add a ## Quick start section near the top of .claude/skills/implement-feature/SKILL.md, immediately after the opening paragraph and before ## Steps. The section should show the three realistic invocation patterns as annotated bullet points, so a user can orient themselves before reading the full step-by-step.

The three patterns:

  1. Named run/implement-feature pr-review-doc-context-enrichment — targets a specific feature slug directly
  2. Auto-select/implement-feature with no argument — scans docs/issues/ and picks the first fully ready-for-agent feature alphabetically
  3. Overnight loop/loop /implement-feature — composes with the /loop skill to drain the queue unattended; the runner emits LOOP_COMPLETE when no qualifying feature remains, which terminates the loop

No separate EXAMPLES.md file is needed — docs/agents/feature-runner.md already covers lifecycle and mechanics in prose.

Acceptance criteria

  • A ## Quick start section exists in SKILL.md between the opening paragraph and ## Steps
  • The section contains exactly the three invocation patterns listed above, each as a bullet with a concrete example command and a one-line description
  • No new files are created (no EXAMPLES.md)
  • The rest of SKILL.md is unchanged

Blocked by

#80

Comments

This was generated by AI during triage.

Agent Brief

Category: enhancement
Summary: Add a ## Quick start section to the implement-feature skill so users can orient themselves before reading the full 7-step workflow.

Current behavior:
The implement-feature SKILL.md opens with a one-paragraph description and jumps directly into ## Steps. A user invoking the skill for the first time must read all 7 steps to understand the three basic usage patterns.

Desired behavior:
A ## Quick start section appears between the opening paragraph and ## Steps. It contains exactly three bullet points — one per invocation pattern — each with a concrete example command and a one-line description of what it does. No new files are created.

Key interfaces:

  • The implement-feature SKILL.md top-level structure: frontmatter → opening paragraph → ## Quick start## Steps
  • The three invocation patterns (content defined in ## What to build) must match the behavior already implemented in Step 0 of SKILL.md

Acceptance criteria:

  • A ## Quick start section exists in SKILL.md between the opening paragraph and ## Steps
  • The section contains exactly three bullet points covering: named run, auto-select, and overnight loop via /loop
  • Each bullet includes a concrete example command and a one-line description
  • No new files are created (no EXAMPLES.md or other companion files)
  • All other sections of SKILL.md are unchanged

Out of scope:

  • Changing any step logic or the 7-step structure
  • Creating an EXAMPLES.md file
  • Updating docs/agents/feature-runner.md

PRD: docs/issues/feature-runner/PRD.md
Migrated from: docs/issues/feature-runner/11-quick-start.md (source removed after migration)
Touched by PRs: #25, #32

Metadata

Metadata

Assignees

No one assigned

    Labels

    closedPR has been mergedenhancementNew feature or requestfeature/feature-runnerIssues from the feature-runner feature

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions