Agent skill · luongnv89
agent-config
Create or update CLAUDE.md and AGENTS.md files following official best practices. Use when asked to create, audit, or improve agent config files (CLAUDE.md, AGENTS.md). Don't use for README/contributor docs or non-Claude IDE plugins.
What it needs
About 8k tokens when loaded.
What this skill does
When to Use Use when the user asks to create, update, audit, or improve CLAUDE.md or AGENTS.md. Skip for generic README or contributor-doc work. Core Principle These files are context, not enforced configuration. They are loaded every session and the agent may still deviate. Short, specific, always-on facts go in the file. Multi-step procedures go in a skill. "Must never happen" goes in a PreToolUse hook plus permissions. "Verify the work" goes in tests or CI, not a sentence. Write the constitution here; enforce the law somewhere else. Full rules and their sources: references/official-standards.md. Which layer owns a given instruction: references/knowledge-routing.md. Prerequisites Run inside a git repo with origin set; the skill requires a clean tree before destructive edits. Tools: git, file write access to the target path. Confirm whether the user wants CLAUDE.md, AGENTS.md, or both before writing. Repo Sync Before Edits (mandatory) Sync the current branch with remote before any create/update/delete. This is a destructive workflow — always dry-run first with git fetch (read-only) and inspect status before pulling. If the working tree is dirty, back up via stash before syncing: If origin is missing, rebase conflicts occur, or stash pop fails, stop and confirm with the user before continuing. Never overwrite an existing CLAUDE.md / AGENTS.md without first reading it and showing a diff. User Input Recognised inputs: create, update, audit, or a path (e.g., src/api/CLAUDE.md). Step 1: Determine Target File If unspecified, ask which file: AGENTS.md — the cross-agent source of truth, readable by any coding agent (Claude Code, Codex, others). A README for agents: setup, commands, layout, style deltas, tests, PR rules, security. Plain Markdown, no schema. Closest file wins, so nested copies override ancestors. CLAUDE.md — Claude-specific context loaded each conversation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills luongnv89/agent-config