Skip to content

feat(creating-skills): scaffold-skill — generate new skills from a natural language description#7

Open
aldorea wants to merge 1 commit into
mainfrom
feat/scaffold-skill
Open

feat(creating-skills): scaffold-skill — generate new skills from a natural language description#7
aldorea wants to merge 1 commit into
mainfrom
feat/scaffold-skill

Conversation

@aldorea
Copy link
Copy Markdown
Collaborator

@aldorea aldorea commented Apr 21, 2026

Summary

  • Nueva skill /creating-skills:scaffold-skill que genera toda la estructura de una skill a partir de una descripción en lenguaje natural.
  • Añade el directorio commands/ al plugin creating-skills (faltaba).
  • Diseño documentado en docs/plans/2026-04-21-scaffold-skill-design.md.

Cómo funciona

  1. Phase 0 — Descubre los plugins disponibles en el repo dinámicamente (ls ${CLAUDE_PLUGIN_ROOT}/../)
  2. Phase 1 — Dos preguntas: plugin/nombre y descripción en lenguaje natural
  3. Phase 2 — Infiere sin preguntar: model, disable-model-invocation, necesidad de adapters/ y references/, allowed-tools, argument-hint, y TRIGGER phrases
  4. Phase 3 — Muestra un confirmation card; el usuario puede corregir campos antes de escribir
  5. Phase 4 — Genera solo los archivos que tienen sentido para ese tipo de skill

Archivos generados

Archivo Condición
skills/{name}/SKILL.md Siempre
commands/{name}.md Siempre
skills/{name}/adapters/example.md Si la descripción menciona tecnologías específicas
skills/{name}/references/ Si implica output complejo o templates

Test plan

  • Invocar /creating-skills:scaffold-skill sin argumentos — debe descubrir plugins y hacer las 2 preguntas
  • Describir una skill destructiva ("deploy", "send message") — debe inferir disable-model-invocation: true
  • Describir una skill con kubernetes — debe proponer carpeta adapters/
  • Corregir un campo en el confirmation card — debe actualizar y mostrar el card actualizado
  • Verificar que los archivos generados siguen el patrón ops-suite/refinery

🤖 Generated with Claude Code

…ding

New skill that scaffolds directory structure and pre-filled SKILL.md from
a natural language description. Asks two intake questions (plugin/name and
description), infers model, disable-model-invocation, adapters/, references/,
and allowed-tools, then shows a confirmation card before writing any files.

Generates:
- skills/{name}/SKILL.md with inferred frontmatter and standard step structure
- commands/{name}.md shim for direct invocation
- adapters/example.md if technology-agnostic adapters are needed
- references/ directory if complex output format is expected

Also adds commands/ directory to the creating-skills plugin (previously missing).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@aldorea aldorea self-assigned this Apr 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant