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.
From ak-documentationnpx claudepluginhub akallabet/akallabeth-cc-marketplace --plugin ak-documentationThis skill uses the workspace's default tool permissions.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
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.