references/skill-template.md

GitHub
name<skill-name>
description<leading verb> <task> when <trigger>; use <source of truth> instead of <wrong source>

Use this skill when .

The goal is to .

Core Requirements

Workflow

1. Find the target

<How to identify candidate files/components/issues.>

Completion criterion: .

2. Inspect the source of truth

Completion criterion: .

3. Make the smallest safe change

<How to edit without broadening scope. Include multiple steps / workflow if necessary.>

Completion criterion: .

4. Validate

Run the narrowest relevant validation first, then the repo-required quality gate.

Completion criterion: validation passes or the final report names the exact blocker.

5. Format the response

When running as a CI agent, format your final response according to references/response-template.md. This response becomes the PR body.

Completion criterion: the response follows the template structure and includes all required information for reviewers.

Review Checklist

  • The source of truth was inspected before editing.
  • The change does not encode support-code-only states as real behavior.
  • The diff is small enough to review.
  • The validation command passed or the blocker is documented.
  • The final response follows the response template.