Agent skill · software engineering · sickn33
agents-generator
Generate project-specific AGENTS.md and companion rules by analyzing a codebase. Supports full, minimal, update, and dry-run modes with package-manager detection, monorepos, backups, managed blocks, confidence scoring, and command validation.
Why this skill is useful
Adds executable scripts for generating project-specific AGENTS.md and companion rules based on codebase analysis, which the AI cannot generate from existing knowledge.
What it needs
Requires bun, git installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Skill: agents-generator [!WARNING] [Authorized Use Only] This skill writes or updates AGENTS.md, .agents/rules/, optional platform instruction files, and timestamped backups in the target project. Read the detected inputs and proposed outputs first, obtain approval before changing target files, and use it only inside the user's intended project scope. When to Use Use this skill when the user wants to: create a complete, project-specific AGENTS.md instead of generic agent rules; generate companion rules for detected frameworks, tests, databases, styling, or monorepo packages; create a minimal AGENTS.md, preview changes without writing, or update existing instructions after the stack changes. Do not use it to invent conventions without inspecting the target project, to overwrite instructions outside the user's scope, or to treat generated guidance as a substitute for human review. Generates a tailored AGENTS.md + .agents/rules/.md for the target project — not a template with placeholders, but a living document that matches the project's real toolchain. What you get From a project that uses Bun + Next.js 16 + Tailwind + Vitest + Server Actions, the skill produces: Rules NOT generated: backend.md (no NestJS), database.md (no ORM), i18n.md (hardcoded Spanish), forms.md (manual inputs), styling.md (Tailwind in frontend rules). Activation Contract Generate AGENTS.md + .agents/rules/.md for the target project. Never guess — read the project's actual files first. Mode selection User says Mode Output ----------- ------ -------- "simple AGENTS.md", "just the basics", "minimal" Minimal Single AGENTS.md (~30 lines, no rule files) "full AGENTS.md", "with rules", "complete", or default Full AGENTS.md + .agents/rules/.md "update AGENTS.md", "refresh", "my stack changed" Update Diff existing, regenerate only what changed Dry-run mode If the user asks to "preview", "show what would change", "dry-run": run all detection but do NOT write files. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/agents-generator--034539