kvothesson/ar-plugins / skills/dev
dev
VerifiedSkill 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
descriptionobligatorio, 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.jsontiene name, version, description, author y license, sin camposkills -
claude plugin validate .dice "Validation passed" -
SKILL.mdtiene frontmatter condescription - 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.XXni[monto]) - README del plugin tiene sección "Fuentes" con URLs
-
.gitignoreexiste - 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ándo | Recurso |
|---|---|
| El issue involucra crear o modificar una skill | Documentación de skills |
| Necesitás descubrir otras páginas de docs | Índice completo de docs |
| El issue involucra la estructura de un plugin | AGENT.md del repo (Paso 2) |
| El issue involucra un plugin específico | SPEC.md del repo (Paso 2) |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 468k | Updated | Claude CodeCodex | Verified | Install |
| 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: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |