Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Proposal: move task-specific procedures out of AGENTS.md into `.claude/skills`

Abierto
  • ¿Algo no está bien?
#2,058 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
48/100
Tipo de issue
Refactorización
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
markdown
Área
developer-experience, tooling

Línea de trabajo

Read the current AGENTS.md and compare it with the fork's approach in bompus/codegraph#241; the issue notes that the fork's version will not apply as-is. Identify which procedures belong in .claude/skills and which rules must remain in AGENTS.md, then check that the skills are discoverable by harnesses that do not load them. Done means the current repository's instructions are reorganized without carrying over fork-only rules.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

AGENTS.md loads into every agent session. At 36 KB, most of it is procedure that only matters for one kind of task: cross-platform validation setup, the release flow, installer internals, changelog format. In the bompus/codegraph fork we moved those parts into repo skills and kept the root file for rules an agent can break without noticing. The root file went from 31,790 to 11,792 bytes (bompus/codegraph#241).

Each skill covers one kind of task:

  • codegraph-build-validation: build and test commands, test layout, cross-platform and Windows validation.
  • codegraph-retrieval: the evidence behind the retrieval rules, explore budgets, dynamic-dispatch channels, the Excalidraw worked example.
  • codegraph-installer: src/installer/ internals, agent targets, the Cursor --path quirk.
  • codegraph-release: changelog format and the release flow.
  • codegraph-issue-triage: checking a report against released, merged and in-progress state.

These stayed in the root file, since an agent that never opens the matching skill would break them silently:

  • A short retrieval block. Recoverable conditions return success-shaped guidance instead of isError, explore output never tells the agent to use Read, both explore budgets stay monotonic with file count, and partial dynamic-dispatch coverage is worse than none.
  • The Windows-gated test rule.
  • Installer changes need installer-targets tests and a changelog entry.
  • The README and docs sync rule.
  • A Skills section with one line per skill, telling the agent to read the matching SKILL.md before that work. Codex reads AGENTS.md but not .claude/skills, so this list is how skills reach harnesses that don't load them.

The fork's version won't apply here as-is. Some of its kept rules are fork-only (its branch and release policy, its Rust kernel build), and your AGENTS.md has changed since we split ours. If the idea fits, I can open a PR against the current file, or you can take the parts you want.

Lenguaje dominante
C
Estrellas
73.2k
Forks
4.7k
Merge medio
2 h 16 min
PR fusionados (30 d)
423

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de colbymchenry/codegraph

Todos los issues de colbymchenry/codegraph

Issues similares

Más issues de C

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.