
for AI agents & LLMs
Concise, actionable Angular best practices optimized for AI agents and LLMs. 151 rules across 23 categories, each under 50 lines.
Install
Select the skills you need. Core rules are always included.
How It Works
rules/*.md → build system → AGENTS.md
(granular files) (validate & (single file per skill,
concatenate) consumed by AI agents)
Install via: npx skills add alfredoperez/angular-best-practices
Agents read: AGENTS.md at the project root
Format: Each rule is < 50 lines, 2 code blocks maxRules are stored as individual markdown files, validated for conciseness, then compiled into a single AGENTS.md that AI coding assistants (Claude Code, Cursor, VS Code Copilot) read at the project root.
Rule Categories
Rule Format
--- title: Verb + Subject impact: MEDIUM impactDescription: Brief metric tags: tag1, tag2 --- ## Verb + Subject One sentence explaining the rule. **Incorrect:** ```typescript // 3-5 lines max ``` **Correct:** ```typescript // 3-5 lines max ```
Every rule follows this template: frontmatter with impact metadata, one-sentence description, and at most two code blocks (incorrect + correct). Total file length must be under 50 lines.
Design Philosophy
Concise
Each rule is under 50 lines. AI context windows are expensive — every token must earn its place.
Granular
One file per rule. Easy to add, review, and maintain. No monolithic guides.
Actionable
Incorrect → Correct patterns. AI agents can apply these rules directly to code without interpretation.