convez.ai
SkillDevOps & InfraestruturaIntermediário
rahulkolekardev

AgentCtx

rahulkolekardev/agentctx

Prepare seu repo para agentes de IA com contexto gerado automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que prepara repositórios para trabalhar com agentes de IA como Claude Code, Copilot, Cursor e outros. Escaneia o projeto, detecta fatos relevantes e gera arquivos de contexto mínimos e direcionados para cada tipo de agente, sem despejar toda a codebase em prompts.

Instalação

$npx convez-ai rahulkolekardev/agentctx

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Otimizar repositórios para Claude Code, GitHub Copilot e Cursor
  • Gerar instruções específicas por agente (CLAUDE.md, AGENTS.md, etc)
  • Criar task packs com contexto direcionado para tarefas específicas
  • Documentar estrutura e comandos do projeto para LLMs

Veredito

Ferramenta madura e bem pensada para align repositórios com capacidades de agentes de IA. Suporta múltiplas plataformas (Claude, Copilot, Cursor, Gemini CLI) com geração inteligente de contexto. Recomendado para equipes que usam agentes de código regularmente e querem melhorar qualidade das respostas.

README

A tradução para o português deste README ainda está na fila.

AgentCtx

Make your repo agent-ready.

AgentCtx is an agent skill plus deterministic Node.js helper scripts that prepare repositories for AI coding agents such as Claude Code, OpenAI Codex, Gemini CLI, Google Antigravity, GitHub Copilot, Cursor, Windsurf, Amp, Aider, Cline, Roo Code, Continue, OpenHands, Replit Agent, Zed Agent Panel, and generic LLM tools.

It scans a repository, detects project facts, generates minimal evidence-backed context files, checks stale or risky instructions, and creates task-specific context packs.

Why AgentCtx?

AI coding agents work better when they understand:

  • project commands
  • package manager and framework
  • repo structure
  • architecture patterns
  • safety rules
  • verification steps

AgentCtx does not dump your entire codebase into prompts. It generates short, useful, repo-specific guidance.

What it creates

TargetFile
Codex / generic agentsAGENTS.md
Claude CodeCLAUDE.md
Gemini CLI / Gemini-based coding workflowsGEMINI.md
GitHub Copilot.github/copilot-instructions.md
Cursor.cursor/rules/project.mdc
Web/docs LLM guidancellms.txt
Repo map.repoctx/repo-map.json, .repoctx/repo-map.md
Task pack.repoctx/packs/<task>.md

Quick start

Run directly from this repo:

node skills/agentctx/scripts/agentctx.mjs scan --root examples/nextjs-app
node skills/agentctx/scripts/agentctx.mjs generate --root examples/nextjs-app --dry-run
node skills/agentctx/scripts/agentctx.mjs doctor --root examples/nextjs-app
node skills/agentctx/scripts/agentctx.mjs pack "add login with Google OAuth" --root examples/nextjs-app

If published as an npm binary later, the same commands can become:

npx agentctx scan
npx agentctx generate
npx agentctx doctor
npx agentctx pack "add login with Google OAuth"

Agent coverage

AgentCtx is designed to create reusable repo guidance that works across many AI coding agents.

Agent / platformPrimary AgentCtx outputNotes
OpenAI CodexAGENTS.mdGeneric repo instructions and verification commands.
Claude CodeCLAUDE.mdClaude-specific project memory/instructions.
Gemini CLIGEMINI.mdGemini CLI project context file.
Google AntigravityAGENTS.md, .repoctx/repo-map.md, task packsUse generated repo guidance and task packs as agent instructions.
GitHub Copilot / Copilot coding agent.github/copilot-instructions.mdRepo-level Copilot instructions.
Cursor.cursor/rules/project.mdcProject-wide Cursor rules.
Windsurf / CascadeAGENTS.md, repo map, task packsCopy generated guidance into Windsurf custom instructions when needed.
AmpAGENTS.md, repo map, task packsGeneric agent instructions and verification commands.
AiderAGENTS.md, repo map, task packsUse as onboarding/context before editing.
Cline / Roo CodeAGENTS.md, repo map, task packsUse as project rules/context.
Continue / OpenHands / Replit Agent / Zed Agent PanelAGENTS.md, llms.txt, repo map, task packsGeneric context files plus task-specific packs.

The default generation target is:

node skills/agentctx/scripts/agentctx.mjs generate --target agents,claude,gemini,copilot,cursor --root .

Use --target all to also create llms.txt.

Install from Vercel Skills CLI

After pushing this repo to GitHub, users can install the skill with:

npx skills add rahulkolekardev/agentctx --skill agentctx

Install globally for Claude Code:

npx skills add rahulkolekardev/agentctx --skill agentctx -g -a claude-code -y

Install into a project for supported agents such as Codex, Cursor, and Copilot agent mode:

npx skills add rahulkolekardev/agentctx --skill agentctx -a codex -a cursor -y

List available skills in this repo:

npx skills add rahulkolekardev/agentctx --list

Install from npm

After publishing to npm:

npm install -D agentctx-skill
npx agentctx scan --root .
npx agentctx generate --root . --dry-run
npx agentctx doctor --root .

You can also run without installing:

npx agentctx-skill scan --root .

This npm package bundles the Agent Skills-compatible folder at skills/agentctx/SKILL.md, so skill installers can discover it from node_modules/**/skills/*/SKILL.md.

Publishing

See PUBLISHING.md for GitHub, Vercel Skills CLI, and npm release steps.

Skill installation

Claude Code personal skill

mkdir -p ~/.claude/skills/agentctx
cp -R skills/agentctx/* ~/.claude/skills/agentctx/

Claude Code project skill

mkdir -p .claude/skills/agentctx
cp -R skills/agentctx/* .claude/skills/agentctx/

Codex project skill

mkdir -p .agents/skills/agentctx
cp -R skills/agentctx/* .agents/skills/agentctx/

Commands

Scan

node skills/agentctx/scripts/agentctx.mjs scan --root .
node skills/agentctx/scripts/agentctx.mjs scan --root . --json

Detects framework, package manager, language, scripts, database tooling, CI, and important files.

Generate

node skills/agentctx/scripts/agentctx.mjs generate --root .
node skills/agentctx/scripts/agentctx.mjs generate --root . --target agents,claude,gemini,copilot,cursor,llms
node skills/agentctx/scripts/agentctx.mjs generate --root . --dry-run
node skills/agentctx/scripts/agentctx.mjs generate --root . --force

Generates short AI-agent instruction files. Existing files are not overwritten unless --force is passed.

Map

node skills/agentctx/scripts/agentctx.mjs map --root .
node skills/agentctx/scripts/agentctx.mjs map --root . --stdout

Creates .repoctx/repo-map.json and .repoctx/repo-map.md.

Doctor

node skills/agentctx/scripts/agentctx.mjs doctor --root .
node skills/agentctx/scripts/agentctx.mjs doctor --root . --json
node skills/agentctx/scripts/agentctx.mjs doctor --root . --ci

Calculates an AI Agent Readiness Score and reports missing context files, stale commands, package-manager contradictions, oversized files, missing scripts, missing README/license/CI, and possible secrets.

Pack

node skills/agentctx/scripts/agentctx.mjs pack "fix Stripe webhook bug" --root .
node skills/agentctx/scripts/agentctx.mjs pack "add auth" --root . --stdout

Creates a task-specific context pack with likely relevant files, reasons, commands, safety notes, and verification checklist.

Examples

This repo includes sample projects:

  • examples/nextjs-app
  • examples/express-api
  • examples/nestjs-api

Security

AgentCtx ignores sensitive files by default:

  • .env, .env.*
  • private keys
  • .git
  • node_modules
  • generated build folders
  • cache folders

It also scans generated/context files for obvious secret patterns such as API keys, private keys, GitHub tokens, Slack bot tokens, and cloud credentials.

Why not just use repo packers?

Repo packers are useful when you want to paste a codebase into an LLM. AgentCtx is different:

  • It does not dump all source code.
  • It creates minimal agent instructions.
  • It validates stale or unsafe context.
  • It creates task-specific context packs.
  • It is designed for Codex, Claude Code, Gemini CLI, Google Antigravity, Copilot, Cursor, Windsurf, Amp, Aider, Cline, Roo Code, Continue, OpenHands, Replit Agent, and similar tools.

Local validation

npm run validate

This runs syntax checks, tests, and smoke tests against the sample projects.

Roadmap

  • npm installer package
  • GitHub Action
  • readiness badge
  • Python/FastAPI detector
  • Laravel detector
  • deeper dependency graph
  • MCP server
  • VS Code extension

License

MIT

Ver o original no GitHub

Bom para

Relacionados