inits

Solid

Creates or improves an AGENTS.md file. Use when onboarding to a repo, or capturing conventions, constraints, and rationale that are expensive to rediscover.

AI & Automation 33 stars 0 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 83/100

Stars 20%
51
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Init - AGENTS.md Generator Analyze this codebase and create or improve an `AGENTS.md` file for future ODIN Code Agent instances. ## Governing maxim **`AGENTS.md` records what needs to be, not what it is.** Every entry is a rule, constraint, or obligation a future agent must uphold; it is never a description of the repository's current state. Prescriptive vs. descriptive is the admission gate; everything below refines it. ## Admission gates (in order) 1. **Normative first.** The candidate must prescribe: an imperative, a prohibition, or an invariant to preserve. Descriptions of structure, tooling, or state fail here regardless of accuracy or usefulness. 2. **Expensive to rediscover.** Among prescriptive candidates, keep only those a future agent cannot cheaply re-derive with a search or one file read. Rules enforced loudly by tooling (a linter that fails the build) are self-announcing; omit them. ## Phrasing rule Write each entry as an imperative or prohibition, paired with why the rule needs to be: - Admissible: "Use pnpm; npm lockfiles break CI." - Inadmissible: "The repo uses pnpm." Same fact, but only the normative form carries an obligation. ## What to omit Everything failing a gate: - Repository summaries: file trees, per-directory descriptions, component or dependency inventories (fail gate 1). - Generic development best practices not specific to this repo (fail gate 2). - Fabricated filler sections such as "Common Development Tasks", "Tips", or "Support"....

Details

Author
OutlineDriven
Repository
OutlineDriven/odin-claude-plugin
Created
8 months ago
Last Updated
today
Language
Python
License
Apache-2.0

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category