Agent skill

Agents Generator

by sickn33 in sickn33/agentic-awesome-skills

Generate project-specific AGENTS.md and companion rules by analyzing a codebase.

MITAuto-check: notesDevelopment

Install Agents Generator

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill agents-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills agents-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agents-generator .claude/skills/agents-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agents-generator
GitHub stars
47k
Used in
1 other repo
Token cost
~2.3k tokens
SKILL.md length
913 words
Files
21 (incl. references, assets)
Skills in repo
1,354
Repo updated
First seen
Licence
MIT

At a glance

Generate project-specific AGENTS.md and companion rules by analyzing a codebase.

  • Works in 5 steps: git rev-parse --show-toplevel → project… → Detect package manager FIRST: check… → Read package.json (scripts, deps,… → …
  • Tasks that involve Backup and disaster recovery
  • SKILL.md covers When to Use, What you get, Activation Contract and Hard Rules, plus 4 more sections
  • Calls git

What it does

Agents Generator is an agent skill from sickn33/agentic-awesome-skills. 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.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including reference files and assets (for example `assets/agents-full.md`, `assets/agents-minimal.md` and `assets/agents-nested.md`).

It sits in Development, covering Backup and disaster recovery, Monorepo tooling and Agent instruction files. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Tasks that involve Backup and disaster recovery
  • Tasks that involve Monorepo tooling
  • Tasks that involve Agent instruction files

Example prompts

  • “/agents-generator”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(ls:*), Bash(git:*), Bash(tree:*), Bash(find:*), Grep, Glob, WebFetch

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. git rev-parse --show-toplevel → project root.
  2. Detect package manager FIRST: check lockfiles. bun.lock→bun, pnpm-lock.yaml→pnpm, package-lock.json→npm, yarn.lock→yarn. Never default to…
  3. Read package.json (scripts, deps, workspaces). Save scripts for validation.
  4. Read non-secret config files and explore directory structure. Exclude .env* files other than placeholder-only .env.example; never read…
  5. Select mode (ask if ambiguous).

What it can do on your machine

Read from SKILL.md and the folder at commit ec02547. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(ls:*)
    • Bash(git:*)
    • Bash(tree:*)
    • Bash(find:*)
    • Grep
    • Glob
    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agents Generator loads about 2.3k tokens when it runs, and up to ~9.9k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 913 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:78
    before generating anything. Never open `.env`, `.env.local`, credential stores, or similarly secret-bearing files. Deri
  • NoteMentions a .env fileSKILL.md:93
    nd explore directory structure. Exclude `.env*` files other than placeholder-only `.env.example`; never read secret valu

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit ec02547, republished under its MIT licence (© sickn33). 913 words, ~2,342 tokens.

Download SKILL.mdSave it as .claude/skills/agents-generator/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.
name
agents-generator
description
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.
allowed-tools
Read, Write, Edit, Bash(ls:*), Bash(git:*), Bash(tree:*), Bash(find:*), Grep, Glob, WebFetch
category
developer-tools
risk
critical
source
https://github.com/OJPalenzuela/agents-generator/tree/7a3201208a01bd25e69ad11e665efc1392f5356a
source_repo
OJPalenzuela/agents-generator
source_type
community
date_added
2026-08-02
author
OJPalenzuela
tags
agents-md, project-conventions, developer-tools, codebase-analysis, ai-agents
tools
claude, cursor, copilot, opencode, codex, gemini
license
MIT

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:

AGENTS.md
├── Setup commands: bun install, bun dev, bun run test:run, bun doctor
├── Verification Cycle: bunx tsc --noEmit → bun run lint → bun run test:run → bun doctor
├── Conventions: "Bun always. Plain TypeScript types + guards."
└── Architecture → .agents/rules/architecture.md

.agents/rules/
├── architecture.md       ← ASCII diagram with real directories, exact versions
├── frontend-patterns.md  ← Component rules, state locations, trust boundaries
├── server-actions.md     ← downloadVideo() flow, DownloadResult type, rate limiter
├── testing.md            ← "74 tests in 5 files", vitest commands, mock patterns
├── git-workflow.md       ← Conventional commits, pre-commit checks
└── sdd-workflow.md       ← Preflight defaults, post-apply verification

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 saysModeOutput
"simple AGENTS.md", "just the basics", "minimal"MinimalSingle AGENTS.md (~30 lines, no rule files)
"full AGENTS.md", "with rules", "complete", or defaultFullAGENTS.md + .agents/rules/*.md
"update AGENTS.md", "refresh", "my stack changed"UpdateDiff 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. Show detection summary, files that would be created, skipped rules, and sample output.

Hard Rules

  • Read before writing, but never read secrets. Read package.json, non-secret config files, and directory structure before generating anything. Never open .env, .env.local, credential stores, or similarly secret-bearing files. Derive environment variable names only from .env.example placeholders and source references such as process.env.NAME, without reading or reporting values.
  • Detect package manager FIRST. Check lockfiles: bun.lock→bun, pnpm-lock.yaml→pnpm, package-lock.json→npm, yarn.lock→yarn. NEVER default to npm. Every command uses the detected PM.
  • Generate only what applies. No backend rules for frontend-only. No database rules without ORM.
  • Do not execute project scripts by default. Package-manager scripts are repository-controlled shell entry points. Detect and document candidate format/lint commands, but do not run them unless the user separately requests execution after the exact script body and invoked tooling have been reviewed.
  • Validate commands. Every command in output must exist as a script key in package.json.
  • No placeholders. Scan output for {{, TODO, add here, .... Reject if any remain.
  • Backup first. If files exist, copy to .agents/backups/ with timestamp.

Execution Steps

Common
  1. git rev-parse --show-toplevel → project root.
  2. Detect package manager FIRST: check lockfiles. bun.lock→bun, pnpm-lock.yaml→pnpm, package-lock.json→npm, yarn.lock→yarn. Never default to npm.
  3. Read package.json (scripts, deps, workspaces). Save scripts for validation.
  4. Read non-secret config files and explore directory structure. Exclude .env* files other than placeholder-only .env.example; never read secret values.
  5. Select mode (ask if ambiguous).
Full mode
  1. Read assets/agents-full.md — this is the AGENTS.md structure with all sections and filling rules.
  2. Read project files and fill every placeholder with real data. Never use generic text.
  3. Generate AGENTS.md at project root. Wrap content in <!-- AGENTS-GENERATED-START --> / <!-- AGENTS-GENERATED-END -->.
  4. For each applicable rule category, read the corresponding template from assets/ and generate the rule file in .agents/rules/.
  5. If Claude detected (.claude/ or CLAUDE.md): generate thin CLAUDE.md from assets/claude.md.
  6. If platform files detected: generate from assets/platform.md.
Show full SKILL.md (330 more words)Show less
Minimal mode
  1. Read assets/agents-minimal.md — 30-line agents.md standard format.
  2. Generate single AGENTS.md.
Update mode
  1. Backup existing files.
  2. Re-detect project state.
  3. Diff old vs new. Regenerate only changed categories.
Post-generation
  • Report the detected [format cmd] and [lint cmd] as unexecuted candidates. Run neither automatically; execute one only after the user separately authorizes it and its exact project-controlled script body has been reviewed.
  • Scan for {{, TODO, .... Fix any found.
  • Verify all commands exist in package.json scripts.
  • If AGENTS.md > 300 lines, warn. If > 500, move content to rule files.
  • Summarize all changes using conventional commit format before declaring done.
  • Report: what was detected, generated, skipped, and confidence score.

Output Contract

Return:

  • Mode used and why
  • Files created/modified
  • Detection summary (all categories)
  • Rules generated and skipped (with reason)
  • Confidence score

Limitations

  • Generated instructions are proposals and require human review before they are adopted or committed.
  • Command validation is limited to scripts and files visible in the target project; it cannot prove that tools, services, or platform-specific commands will work in every environment.
  • Project-provided package scripts are untrusted executable code. Generation and documentation of a script do not authorize running it.
  • The skill does not authorize writes outside the intended project scope or replace project-specific security, build, or deployment review.

References

PriorityFilePurpose
Requiredassets/agents-full.mdFull AGENTS.md template with all 25+ sections and filling rules
Requiredassets/agents-minimal.md30-line agents.md standard template
Full modeassets/architecture.mdArchitecture rules template
Full modeassets/frontend-patterns.mdFrontend patterns template
Full modeassets/server-actions.mdServer actions / backend template
Full modeassets/testing.mdTesting strategy template
Full modeassets/git-workflow.mdGit workflow template
Full modeassets/sdd-workflow.mdSDD workflow template
Full modeassets/styling.mdStyling rules template
Full modeassets/forms.mdForm patterns template
Full modeassets/database.mdDatabase rules template
Full modeassets/i18n.mdi18n rules template
Full modeassets/backend.mdBackend/NestJS template
Conditionalassets/claude.mdCLAUDE.md — only if Claude detected
Conditionalassets/platform.mdMulti-platform files
Conditionalassets/agents-nested.mdMonorepo nested AGENTS.md
Referencereferences/decision-matrix.mdFull detection logic and edge cases
Referencereferences/example-output/README.mdQuality benchmark
Referencereferences/template-filling-guide.mdPlaceholder filling rules

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 20 other files (references, assets) in skills/agents-generator of sickn33/agentic-awesome-skills.

  • SKILL.md
  • assets/agents-full.md
  • assets/agents-minimal.md
  • assets/agents-nested.md
  • assets/architecture.md
  • assets/backend.md
  • assets/claude.md
  • assets/database.md
  • assets/forms.md
  • assets/frontend-patterns.md
  • assets/git-workflow.md
  • assets/i18n.md
  • assets/platform.md
  • assets/sdd-workflow.md
  • assets/server-actions.md
  • assets/styling.md
  • assets/testing.md
  • references/decision-matrix.md
  • references/example-output
  • … and 2 more

Open the folder on GitHubat commit ec02547

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agents Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agents Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agents Generator this skillsickn33/agentic-awesome-skills47k1 repos~2.3kAutomated safety check: NotesMIT
Dx Harnesspproenca/dot-skills215—~1.5kAutomated safety check: PassMIT
Acreadiness Generate Instructionsgithub/awesome-copilot40k1 repos~2.1kAutomated safety check: PassMIT
Openiap Workflowshyodotdev/openiap154—~2kAutomated safety check: PassMIT
Repo Scaffoldmajiayu000/spellbook286—~651Automated safety check: PassMIT
SetupAlexZio00/sovereign-skills139—~9.2kAutomated safety check: PassMIT

Similar skills

  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    215 GitHub stars~1.5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Acreadiness Generate Instructions

    github/awesome-copilot

    Official

    Generate tailored AI agent instruction files via AgentRC instructions command.

    40k GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed
  • Openiap Workflows

    hyodotdev/openiap

    A skill your agent uses for OpenIAP monorepo work that should follow the repository's shared agent workflows, including review-pr, audit-code, audit-security, audit-iapkit, compile-knowledge…

    154 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Repo Scaffold

    majiayu000/spellbook

    Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs.

    286 GitHub stars~651 tokensUpdated today
    DevelopmentAuto-check passed
  • Setup

    AlexZio00/sovereign-skills

    Claude Code infrastructure + agent team setup — rules, hooks, memory, routing, and agent installation from a guided interview.

    139 GitHub stars~9.2k tokensUpdated 13 days ago
    DevelopmentAuto-check passed
  • Scaffold

    team-attention/hoyeon

    Greenfield project architecture + harness scaffolding for AI Agent productivity.

    173 GitHub stars~6.9k tokensUpdated 4 mo ago
    DevelopmentAuto-check: notes

More from sickn33/agentic-awesome-skills

All 1,354 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Content Creator

    sickn33/agentic-awesome-skills

    Drafts and reviews audience-specific content from supplied brand examples, with local scripts for brand voice and SEO diagnostics, channel templates and a content calendar.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed

Questions about Agents Generator

What does Agents Generator do?

Generate project-specific AGENTS.md and companion rules by analyzing a codebase. Agents Generator is an agent skill from sickn33/agentic-awesome-skills.md and companion rules by analyzing a codebase.

When should I use Agents Generator?

Agents Generator fits situations like: tasks that involve Backup and disaster recovery; tasks that involve Monorepo tooling; tasks that involve Agent instruction files.

How do I install Agents Generator in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill agents-generator -a claude-code`. Or copy the skill folder (skills/agents-generator in sickn33/agentic-awesome-skills) into .claude/skills/agents-generator in your project. Claude Code loads it when a task matches its description.

How do I install Agents Generator in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill agents-generator -a codex`. Or copy the skill folder (skills/agents-generator in sickn33/agentic-awesome-skills) into .agents/skills/agents-generator in your project. Codex loads it when a task matches its description.

Can I use Agents Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill agents-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agents-generator, .gemini/skills/agents-generator, .github/skills/agents-generator and .opencode/skills/agents-generator in your project.

What does Agents Generator need to run?

Going by SKILL.md and its folder, Agents Generator needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(ls:*), Bash(git:*), Bash(tree:*), Bash(find:*), Grep, Glob, WebFetch.

Does Agents Generator access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Agents Generator safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Agents Generator use?

Agents Generator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agents Generator use?

About 2.3k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.5k tokens, read only when the agent opens those files.

What are the alternatives to Agents Generator?

Skills that share tags, products or a category with Agents Generator: Dx Harness (pproenca/dot-skills, 215 stars), Acreadiness Generate Instructions (github/awesome-copilot, 40k stars), Openiap Workflows (hyodotdev/openiap, 154 stars) and Repo Scaffold (majiayu000/spellbook, 286 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agents Generator?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,343 GitHub stars. The repository holds 1,354 skills in this directory. The repository was last updated on October 7, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.