Agents md compact
Skill roronoazoroshao369/vibe-coding-os/skills/templates/agents-md-compact
Vibe Coding OS — Claude/Codex/Cursor skill framework with 139 skills, 111 commands, 95 templates, 22 tracked sources, 28/28 validation gates PASS. Quality Shield, Engineering Discipline Pack, plugin marketplace.
npx -y skills add roronoazoroshao369/vibe-coding-os --skill agents-md-compactAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.3 KB, as published. Nobody here has run it
Skill: Agents-MD-Compact Template
Purpose
Generate or adapt a concise, high-signal AGENTS.md (or CLAUDE.md, CODER.md, etc.) that gives coding agents the minimum context they need to work safely and correctly in a project. The template focuses on validation commands, project layout, architectural constraints, protected paths, approved dependencies, quality gates, and response format — not narrative history.
When to use
- New project onboarding: when a project has no agent instruction file or the existing one is stale.
- Session bootstrap: when starting work in an unfamiliar repo and the agent instructions are missing or inadequate.
- Command adaptation: when the
vibe-agents-mdcommand needs to regenerate or patch the agent instructions. - Refactor / cleanup: when an existing
AGENTS.mdis bloated, outdated, or mixes narrative with operational guidance.
Inputs
- Repository root path and branch.
- Existing
AGENTS.md,CLAUDE.md, or equivalent file (if any). - Validation commands the project supports (e.g.,
npm run validate). - Known protected paths, do-not-edit zones, and approved dependencies.
- Any architecture constraints, quality gate checklist, or preferred response format.
Workflow
- Read any existing agent instruction file at the repository root.
- Run
ls/ directory inspection to confirm the real project layout. - Identify the primary validation commands by checking
package.json,Makefile, or equivalent. - Identify protected paths (generated files, vendor directories, lock files, registry files).
- Draft the compact
AGENTS.mdusingtemplates/agents-md-compact.mdas a skeleton. - Fill each section with concrete, project-specific facts — not generic advice.
- Keep the file under 120 lines. Prefer bullet lists over prose.
- Verify the generated file has no placeholder text left.
- Save to the repository root.
Outputs
A complete, concise AGENTS.md file at the repository root containing:
- Project overview (2–3 sentences).
- Validation commands.
- Project layout (top-level directories, key files).
- Architecture constraints.
- Do-not-edit paths.
- Approved dependencies.
- Quality gate checklist.
- Response format preferences.
Failure modes
- Producing a generic template with no project-specific content.
- Exceeding 120 lines with narrative instead of actionable bullets.
- Omitting validation commands that the agent needs to run.
- Listing secrets, tokens, or credentials in any section.
- Leaving placeholder text like
[fill this in]in the final file. - Duplicating information already in
README.mdinstead of pointing to it.
Verification checklist
- File is under 120 lines.
- Every section contains concrete, project-specific information.
- Validation commands are listed and correct.
- Protected paths are explicit.
- No placeholder or template text remains.
- No secrets, tokens, or credentials appear anywhere.
- The file points to other docs rather than duplicating them.