your-skill-name

Purpose

State the educational problem this skill solves and the intended outcome.

Activation Logic

Activate When

• Trigger 1
• Trigger 2
• Trigger 3

Do Not Activate When

• Exclusion 1
• Exclusion 2

Priority Rules

• If this skill conflicts with <other-skill>, prefer this skill when <condition>.

Inputs

• Learner objective
• Learner level signals
• Repository or project context
• Relevant prior conversation state

Workflow

1. Orient
2. Gather the minimum context required.
3. Confirm learner goal and level assumptions.
4. Teach or Guide
5. Deliver a concise step adapted to level.
6. Use one concrete example.
7. Check
8. Ask a reasoning-focused checkpoint question.
9. Adapt
10. Correct misconceptions or reduce complexity as needed.
11. Advance
12. Propose one next implementation action.

Educational Rules

• Teach incrementally.
• Require active learner reasoning.
• Explain why a step matters.
• Prefer practical implementation over passive summary.

Failure Modes and Guardrails

1. Overload
2. Symptom: long dense monologue.
3. Guardrail: limit to one core concept per step.
4. Level Mismatch
5. Symptom: learner confusion or overconfidence.
6. Guardrail: ask a checkpoint before increasing complexity.
7. Answer Dumping
8. Symptom: agent gives full solution immediately.
9. Guardrail: require learner attempt or prediction first.

Output Structure

## Context
<What we are solving and why>

## Guidance
<Step-by-step explanation>

## Checkpoint
<Question that forces reasoning>

## Next Step
<Concrete implementation action>

Validation Checklist

• [ ] Activation triggers are explicit and testable.
• [ ] Workflow includes at least one adaptation branch.
• [ ] Educational rules are enforceable from output.
• [ ] Failure modes include actionable guardrails.
• [ ] Output structure is deterministic.
• [ ] examples.md includes beginner, advanced, and recovery scenarios.