Agent Instructions

Escribe un CLAUDE.md/AGENTS.md que lista solo comandos verificados y problemas reales

Por nimadorostkar · nimadorostkar/Claude-Skills-collection

Probado · Funciona ★ 9.2/10

Agent Instructions — Escribe un CLAUDE.md/AGENTS.md que lista solo comandos verificados y problemas reales

Qué hace

Guía para escribir el archivo de instrucciones del proyecto que un agente de codificación lee antes de tocar tu repositorio — CLAUDE.md, AGENTS.md o equivalente. Insiste en que cada comando en el archivo se ejecute antes de ser escrito, y que el archivo registre las fallas observadas del agente y las restricciones difíciles en lugar de reafirmar lo que el código ya dice. Se activa cuando pides escribir, actualizar o corregir un archivo de instrucciones del proyecto.

Informe de la prueba

Escribí un CLAUDE.md para el repositorio consensus-loop dos veces y luego ejecuté cada comando en ambos archivos. La versión sin skill incluía cinco comandos, de los cuales tres estaban rotos, incluyendo `node --test tests/` — el comando exacto que lleva el CLAUDE.md real del repositorio, que falla en Node 26 con 'Cannot find module <repo>/tests'. Siguiendo la regla de la skill de que los comandos deben ejecutarse antes de ser escritos, dos de esas trampas se convirtieron en líneas explícitas de no ejecutar con el texto de error real, y surgió una tercera: `npm run quality` en test-harness no puede pasar porque falta @types/node, por lo que `npx vitest run` (44/44 verde) lo reemplazó. El costo del archivo mejor fue de 59 líneas contra 39.

Probado el: 2026-08-07 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/nimadorostkar/Claude-Skills-collection.git
mkdir -p ~/.claude/skills
cd Claude-Skills-collection && cp -r skills/agent-tooling/agent-instructions ~/.claude/skills/agent-instructions

Comandos y prompts de ejemplo

  • /agent-instructionsEscribe un CLAUDE.md/AGENTS.md que lista solo comandos verificados y problemas reales

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Write a CLAUDE.md for this repo listing only verified commands
  • Refresh our AGENTS.md so it reflects real agent failures we hit
  • Fix our project instruction file, it has commands that don't run