Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From ak-documentation
Creates, updates, or optimizes an AGENTS.md file for a repository with minimal, high-signal instructions covering non-discoverable coding conventions, tooling quirks, workflow preferences, and project-specific rules that agents cannot infer from reading the codebase. Use when setting up agent instructions or Claude configuration for a new repository, when an existing AGENTS.md is too long, generic, or stale, when agents repeatedly make avoidable mistakes, or when repository workflows have changed and the agent configuration needs pruning. Applies a discoverability filter—omitting anything Claude can learn from README, code, config, or directory structure—and a quality gate to verify each line remains accurate and operationally significant.
npx claudepluginhub akallabet/akallabeth-cc-marketplace --plugin ak-documentationHow this skill is triggered — by the user, by Claude, or both
Slash command
/ak-documentation:initThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill when creating or updating `AGENTS.md` for a repository.
Creates, updates, and maintains AGENTS.md/CLAUDE.md files with concise agent instructions derived from project toolchain analysis, enforcing minimal high-signal best practices.
Creates and maintains concise AGENTS.md and CLAUDE.md files for AI agent instructions, including commands, conventions, external references, and commit rules. Useful for repo-wide agent doc setup and updates.
Creates, refreshes, or validates repo AGENTS.md files using evidence from files, git history, CI to keep them concise and current. Use when missing, stale, or after refactors/tooling changes.
Share bugs, ideas, or general feedback.
Use this skill when creating or updating AGENTS.md for a repository.
Use it especially when:
AGENTS.md is long, generic, or staleTreat AGENTS.md as a living list of non-discoverable landmines and workflow gotchas, not a codebase overview.
Before adding any line, ask:
Can an agent discover this by reading the repo (
README, code, config, scripts, directory tree)?
AGENTS.md.Include only guidance that is:
Typical examples:
uv instead of pip)--no-cache due to fixture behavior)Do not include:
Prefer short, high-signal sections such as:
Scope & routing (which areas need separate/module-local AGENTS files)Non-discoverable commandsLandmines / do-not-touch areasTask-specific constraintsFor large repos, recommend hierarchical AGENTS.md files near relevant modules instead of one monolithic root file.
AGENTS.mdREADME.mdPROJECT.md (if present).cursor/rules/ or .cursorrules).github/copilot-instructions.md)GEMINI.mdIf AGENTS.md exists, improve it incrementally instead of replacing it blindly.
AGENTS.md is temporary guidance, not permanent configuration.
When recurring issues appear:
For each line in AGENTS.md, verify:
Delete any line that fails one of these checks.