Skip to content

kvothesson/ar-plugins / skills/dev

Skill de desarrollo para ar-plugins. Dado un número de issue, lo implementa, verifica las fuentes y abre un PR. Usalo con /dev resolver

Skill: /dev

Comandos

/dev resolver #<número>

Resolvé el issue indicado de kvothesson/ar-plugins, implementá el cambio, verificá que funcione y abrí un PR.


Paso 0 — Leer el issue y generar el plan

gh issue view <número> --repo kvothesson/ar-plugins

Antes de tocar cualquier archivo, determiná qué tipo de cambio es y generá la todolist con TodoWrite. Los ítems deben ser específicos para este issue — no genéricos. Ejemplos según tipo:

Plugin nuevo:

  • Leer AGENT.md y SPEC.md
  • Verificar fuentes: [url1], [url2] (una por skill planificada)
  • Crear branch feat/issue-N-nombre
  • Crear estructura: plugin.json, SKILL.md, README, .gitignore
  • Testear cada comando del SKILL.md
  • Verificar checklist completo
  • Commit y push
  • Agregar entrada a marketplace.json
  • Actualizar README de ar-plugins si agrega skills/workflows
  • Abrir PR

Fix de plugin existente:

  • Leer AGENT.md
  • Clonar repo kvothesson/
  • Crear branch fix/issue-N-descripcion
  • Implementar el fix concreto: [qué hay que cambiar]
  • Verificar que la URL/fuente afectada responde
  • Commit y push
  • Abrir PR

Cambio en marketplace o docs:

  • Leer AGENT.md
  • Crear branch y hacer el cambio puntual
  • Commit y push
  • Abrir PR

Marcá cada ítem como completado a medida que avanzás.


Paso 1 — Leer el contexto

Determiná el tipo de cambio:

  • Plugin nuevo → seguir flujo completo
  • Fix o actualización de plugin existente → clonar ese repo y modificar
  • Cambio en marketplace o docs → modificar directamente en ar-plugins

Paso 2 — Leer el contexto

Siempre leer AGENT.md antes de tocar archivos:

gh api repos/kvothesson/ar-plugins/contents/AGENT.md --jq '.content' | base64 -d

Si es plugin nuevo, leer también SPEC.md para la descripción completa del plugin:

gh api repos/kvothesson/ar-plugins/contents/SPEC.md --jq '.content' | base64 -d

Para ver un plugin de referencia:

gh api repos/kvothesson/arca/contents/skills/arca/SKILL.md --jq '.content' | base64 -d

Paso 3 — Verificar fuentes

Para cada skill del plugin, verificá que las URLs funcionen antes de escribir el SKILL.md:

  • WebFetch a cada URL → ¿responde? ¿datos legibles y útiles?
  • Si falla → buscar alternativa con WebSearch site:<organismo>.gob.ar [tema]
  • Guardar qué URLs funcionaron — son las que van en el SKILL.md y en los ejemplos del README

Sin URLs verificadas no se escribe el SKILL.md.


Paso 4 — Crear branch y clonar

Para cambios en ar-plugins directamente:

gh repo clone kvothesson/ar-plugins /tmp/ar-plugins-fix-<N>
cd /tmp/ar-plugins-fix-<N>
git checkout -b feat/issue-<N>-<descripción-corta>

Para cambios en el repo de un plugin:

gh repo clone kvothesson/<nombre> /tmp/<nombre>-fix-<N>
cd /tmp/<nombre>-fix-<N>
git checkout -b fix/issue-<N>-<descripción-corta>

Para plugin nuevo (repo propio):

mkdir -p /tmp/<nombre>/.claude-plugin
mkdir -p /tmp/<nombre>/skills/<nombre>
cd /tmp/<nombre>
git init

Paso 5 — Implementar

Estructura obligatoria de todo plugin:

<nombre>/
  .claude-plugin/
    plugin.json
  skills/
    <nombre>/
      SKILL.md
  README.md
  .gitignore

plugin.json:

{
  "name": "<nombre>",
  "version": "1.0.0",
  "description": "<descripcion corta sin emojis>",
  "author": { "name": "Kvothesson", "url": "https://github.com/kvothesson" },
  "homepage": "https://github.com/kvothesson/<nombre>",
  "repository": "https://github.com/kvothesson/<nombre>",
  "license": "MIT"
}

Sin campo skills: Claude Code encuentra solo skills/<nombre>/SKILL.md. El formato viejo (array de objetos con name y path) hace que el plugin no se pueda instalar. Copiar también el LICENSE de ar-plugins.

Reglas del SKILL.md (nunca violarlas):

  • Frontmatter con description obligatorio, entre comillas simples (un : sin comillas rompe el YAML y la skill carga sin descripción)
  • Nunca hardcodear montos, fechas ni requisitos — siempre WebFetch/WebSearch a fuente primaria
  • URL exacta a fetchear para cada comando
  • Formato de respuesta con bloque de código de ejemplo
  • Fallback si la URL principal falla
  • Sección de tono al final
  • Siempre mostrar fuente y fecha del dato en la respuesta

Para fix/actualización: solo modificar lo pedido. Sin refactors no solicitados.


Paso 6 — Testear

Para cada comando del SKILL.md, ejecutá las búsquedas/fetches que el skill haría en producción y verificá resultados. Usá esos datos reales para escribir los ejemplos del README — sin placeholders.

Checklist antes de continuar:

  • plugin.json tiene name, version, description, author y license, sin campo skills
  • claude plugin validate . dice "Validation passed"
  • SKILL.md tiene frontmatter con description
  • Cada URL de fetch verificada y funcional
  • Cada skill tiene formato de respuesta definido en bloque de código
  • Cada skill tiene fallback
  • README del plugin tiene ejemplos con datos reales (no $XX.XX ni [monto])
  • README del plugin tiene sección "Fuentes" con URLs
  • .gitignore existe
  • Si el cambio agrega skills o workflows nuevos: README de ar-plugins actualizado

Paso 7 — Commit y push

Para plugin existente (fix):

git add -A
git commit -m "fix: <descripción corta> (closes #<N>)"
git push origin <branch>

Para plugin nuevo:

git add -A
git commit -m "feat: plugin <nombre> v1.0.0"
gh repo create kvothesson/<nombre> --public \
  --description "Plugin de Claude Code — <descripción>" \
  --source . --remote origin --push

Paso 8 — Actualizar marketplace.json (si aplica)

Si el cambio agrega un plugin nuevo o modifica su versión, actualizar .claude-plugin/marketplace.json en ar-plugins:

# Editar .claude-plugin/marketplace.json en el branch actual:
# - Plugin nuevo: agregar entrada al array "plugins"
# - Versión actualizada: cambiar "version" en la entrada existente
git add .claude-plugin/marketplace.json
git commit -m "feat: agrega <nombre> al marketplace"

Paso 9 — Abrir el PR

gh pr create \
  --repo kvothesson/ar-plugins \
  --title "<descripción corta>" \
  --body "Closes #<N>

## Qué hace
<descripción del cambio>

## Cómo se testeó
<URLs verificadas, datos obtenidos, fallbacks probados>"

Tono del proceso

  • Seguir AGENT.md al pie de la letra — es el contrato de calidad del ecosistema
  • Resolver con sentido común ante ambigüedad, sin preguntar lo obvio
  • Si algo está bloqueado (URL caída, permisos), informar el blocker concretamente antes de seguir

Referencias

Recursos a consultar según lo que pida el issue — no son siempre necesarios, usarlos cuando aplique:

CuándoRecurso
El issue involucra crear o modificar una skillDocumentación de skills
Necesitás descubrir otras páginas de docsÍndice completo de docs
El issue involucra la estructura de un pluginAGENT.md del repo (Paso 2)
El issue involucra un plugin específicoSPEC.md del repo (Paso 2)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall