Guia canonica para crear una skill nueva en pm-workspace que supere el auditor de calidad.
Authoritative Paths
Lee estos paths antes de actuar.
Para
Lee este path
Template SKILL.md
.opencode/skills/_template/SKILL.md
Template DOMAIN.md
.opencode/skills/_template/DOMAIN.md
Protocolo de template
docs/rules/domain/skill-template-protocol.md
Auditor de calidad
scripts/skill-catalog-auditor.sh
Registro de skills
SKILLS.md
Cuando usar
Una tarea se repite 2+ veces en sesiones distintas.
Una tarea tarda mas de 15 minutos y sigue un patron reutilizable.
Un patron nuevo aparece que ningun skill existente cubre.
Cuando NO usar
La tarea es un comando puntual que no se repetira.
Ya existe una skill con el mismo scope — ampliar la existente.
La tarea es solo configuracion de proyecto (usar regla en docs/rules/).
Decision Checklist
La tarea se ha repetido 2+ veces? Si NO: documenta como nota, no como skill.
Existe ya una skill solapada? Si SI: ampliar esa skill en lugar de crear una nueva.
El nombre es un verbo o patron de accion? Si NO: renombrar antes de crear.
Abort Conditions
Si la skill resultante superaria 150 lineas, dividirla en dos skills especializadas.
Si no puedes rellenar DOMAIN.md ## Por que existe esta skill en 2 frases, la skill no deberia existir.
Workflow
Detectar patron repetido
|
Copiar template a .claude/skills/<nombre>/
|
Rellenar SKILL.md y DOMAIN.md
|
Verificar con auditor (debe dar OK)
|
Registrar en SKILLS.md
Rellenar SKILL.md: sustituir todos los <placeholder>. Seguir patron "Authoritative Paths First" (SE-153). Borrar bloque HTML inicial. Si la skill no es orquestadora, borrar la seccion Subagent Scope Guard.
Rellenar DOMAIN.md: max 60 lineas. Cubrir: por que existe, conceptos de dominio, limites, confidencialidad, referencias.
Criterio PASS: SKILL.md existe, DOMAIN.md existe, frontmatter con name y description presentes, SKILL.md <= 150 lineas, DOMAIN.md <= 60 lineas, DOMAIN.md > 3 lineas, SKILL.md referencia al menos un path real.
Registrar: ejecutar bash scripts/skills-md-generate.sh para regenerar SKILLS.md.
Outputs esperados
.claude/skills/<nombre>/SKILL.md (<=150 lineas)
.claude/skills/<nombre>/DOMAIN.md (<=60 lineas)
SKILLS.md actualizado
Auditor: resultado OK sin FAIL
Dos tipos de skill (lección SE-347 / Prime Agent)
Decide el tipo ANTES de copiar el template:
Tipo
Cuándo
Template
Contrato
Markdown (instrucciones)
La capacidad es sobre todo procedimiento
.claude/skills/_template/
SKILL.md guía al agente
Python-backed
El agente debe invocar funcionalidad reutilizable con contrato tipado
.claude/skills/_template_python/
SKILL.md + pyproject.toml + src/<import>/__init__.py con run(...)
Reglas del tipo Python-backed:
El import name es el nombre del skill con - → _ (ej. release-audit → release_audit).
1---2name: write-a-skill3description: "Skill: Write a Skill"4---56# Skill: Write a Skill78Guia canonica para crear una skill nueva en pm-workspace que supere el auditor de calidad.910## Authoritative Paths1112> Lee estos paths antes de actuar.1314| Para | Lee este path |15|---|---|16| Template SKILL.md | `.opencode/skills/_template/SKILL.md` |17| Template DOMAIN.md | `.opencode/skills/_template/DOMAIN.md` |18| Protocolo de template | `docs/rules/domain/skill-template-protocol.md` |19| Auditor de calidad | `scripts/skill-catalog-auditor.sh` |20| Registro de skills | `SKILLS.md` |2122## Cuando usar2324- Una tarea se repite 2+ veces en sesiones distintas.25- Una tarea tarda mas de 15 minutos y sigue un patron reutilizable.26- Un patron nuevo aparece que ningun skill existente cubre.2728## Cuando NO usar2930- La tarea es un comando puntual que no se repetira.31- Ya existe una skill con el mismo scope — ampliar la existente.32- La tarea es solo configuracion de proyecto (usar regla en `docs/rules/`).3334## Decision Checklist35361. La tarea se ha repetido 2+ veces? Si NO: documenta como nota, no como skill.372. Existe ya una skill solapada? Si SI: ampliar esa skill en lugar de crear una nueva.383. El nombre es un verbo o patron de accion? Si NO: renombrar antes de crear.3940### Abort Conditions4142- Si la skill resultante superaria 150 lineas, dividirla en dos skills especializadas.43- Si no puedes rellenar `DOMAIN.md ## Por que existe esta skill` en 2 frases, la skill no deberia existir.4445## Workflow4647```48Detectar patron repetido49 |50Copiar template a .claude/skills/<nombre>/51 |52Rellenar SKILL.md y DOMAIN.md53 |54Verificar con auditor (debe dar OK)55 |56Registrar en SKILLS.md57```5859### Detalle de cada paso60611. **Copiar template**:62 ```63 cp -r .claude/skills/_template .claude/skills/<nombre-skill>64 ```65662. **Rellenar SKILL.md**: sustituir todos los `<placeholder>`. Seguir patron "Authoritative Paths First" (SE-153). Borrar bloque HTML inicial. Si la skill no es orquestadora, borrar la seccion `Subagent Scope Guard`.67683. **Rellenar DOMAIN.md**: max 60 lineas. Cubrir: por que existe, conceptos de dominio, limites, confidencialidad, referencias.69704. **Verificar**:71 ```72 bash scripts/skill-catalog-auditor.sh --skill <nombre>73 ```74 Criterio PASS: SKILL.md existe, DOMAIN.md existe, frontmatter con name y description presentes, SKILL.md <= 150 lineas, DOMAIN.md <= 60 lineas, DOMAIN.md > 3 lineas, SKILL.md referencia al menos un path real.75765. **Registrar**: ejecutar `bash scripts/skills-md-generate.sh` para regenerar SKILLS.md.7778## Outputs esperados7980- `.claude/skills/<nombre>/SKILL.md` (<=150 lineas)81- `.claude/skills/<nombre>/DOMAIN.md` (<=60 lineas)82- `SKILLS.md` actualizado83- Auditor: resultado OK sin FAIL8485## Dos tipos de skill (lección SE-347 / Prime Agent)8687Decide el tipo ANTES de copiar el template:8889| Tipo | Cuándo | Template | Contrato |90|---|---|---|---|91| Markdown (instrucciones) | La capacidad es sobre todo procedimiento | `.claude/skills/_template/` | SKILL.md guía al agente |92| **Python-backed** | El agente debe invocar funcionalidad reutilizable con contrato tipado | `.claude/skills/_template_python/` | SKILL.md + `pyproject.toml` + `src/<import>/__init__.py` con `run(...)` |9394Reglas del tipo Python-backed:95961. El import name es el nombre del skill con `-` → `_` (ej. `release-audit` → `release_audit`).972. `src/<import>/__init__.py` debe exponer `run(...)` (callable, async opcional).983. `pyproject.toml` declara el paquete; `[project.scripts]` opcional para CLI.994. Se instala en el venv de python del proyecto (local, CRIT-001 — nunca cloud).1005. El SKILL.md documenta el contrato en `## Usage` (args con nombres y defaults).1016. TDD: escribe el test del callable antes que la implementación (`__init__.test.py`).102103Los skills de digestión/análisis (pdf-digest, excel-digest, tabular-analyst)104son candidatos a migrar a Python-backed progresivamente.105106## Memory hooks107108- Skill nueva creada: guardar en memoria con tipo decision y titulo "skill creada: nombre".109110## Related111112- Template: `.opencode/skills/_template/SKILL.md`113- Rule: `docs/rules/domain/skill-template-protocol.md`114- Auditor: `scripts/skill-catalog-auditor.sh`115- Roadmap: `docs/ROADMAP.md`
Run npx get-skill add gonzalezpazmonica/write-a-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Skill: Write a Skill It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
gonzalezpazmonica (@gonzalezpazmonica) published this skill. Their other Agent Skills are listed on their SkillMD profile.