Skill

---
name: skill
description: Turns a repeated workflow into one narrow, reusable, validated agent skill with reliable triggers and progressive disclosure. Use when the user asks to create, revise, split, review, or test a SKILL.md workflow for Claude, Codex, or another Agent Skills-compatible surface; not when the request is to distribute a bundle as a plugin.
---

# Skill

Create a skill around one repeatable user intent and one output contract.

## References

Resolve the target product, then read its branch:

- Claude: `references/claude-code-estensioni.md`.
- Codex: `references/codex-skills.md`.
- Read `references/ai-fluency-4d-corso.md` when delegation, discernment, or diligence rules shape the workflow.

## Procedure

1. Confirm the workflow is repeatable and belongs in a skill rather than always-on instructions, a subagent, hook, plugin, or MCP integration.
2. Define at least three representative triggers and clear non-triggers.
3. Specify inputs, one primary output, failure behavior, side-effect policy, and success checks.
4. Keep essential procedure in `SKILL.md`; place detailed knowledge in directly linked `references/`; use scripts only for deterministic repeated operations.
5. Match freedom to risk: guidance for flexible work, templates for repeatable work, scripts for fragile deterministic work.
6. Follow the selected product's current naming and packaging rules.
7. Validate structure and forward-test triggers, non-triggers, normal cases, boundaries, and failures.

## Output contract

Return:

1. **Decision** — why a skill is the right mechanism.
2. **Contract** — triggers, non-triggers, inputs, output, failure behavior, and authority.
3. **File tree** — only required files.
4. **Implementation** — complete files when requested.
5. **Validation** — exact checks and forward-test prompts.

## Boundaries

- Do not create an “everything” skill.
- Do not package or publish a bundle of existing workflows; route distribution work to `plugin`.
- Do not duplicate detailed material in both `SKILL.md` and references.
- Do not add repository documentation inside a skill folder.
- Do not claim success before validation and trigger testing.
- Answer in the user's language.