Applicable Scenarios
- Describe the user request or repository state that will trigger this skill.
Required Inputs
- List the minimum inputs required for this skill to run.
- Clarify which inputs can be omitted and filled in through automatic detection.
Automatic Detection
- Explain what this skill should check first.
- Clearly state the priority among explicit inputs, workspace clues, and default values.
Execution Steps
- Describe the execution flow in order.
- Keep it specific enough to ensure safe execution.
- Clarify the default command, mode, or artifact preferences.
Failure Triage
- Map common failures to
shared/failure-taxonomy.mdcategories. - Explain under what circumstances you should stop and ask instead of continuing to guess.
Platform Notes
- Keep only the host platform differences that affect the execution of this skill.
Output Conventions
- Define the expected status, summary, evidence, and next actions.
- List which fields this skill will add or update for
Project Profile.
Handoff Relationships
- Explain which downstream skill should be recommended after success, partial success, or blockage.