Angular performance optimization and best practices guide. Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency.
56
66%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/antigravity-awesome-skills-claude/skills/angular-best-practices/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has a solid structure with an explicit 'Use when...' clause that clearly communicates both purpose and trigger conditions. However, it lacks specific concrete actions (e.g., lazy loading, OnPush change detection, tree shaking) that would help Claude distinguish this skill from a general Angular skill, and the trigger terms could be expanded to cover more natural user phrasings.
Suggestions
Add specific concrete actions like 'Implements OnPush change detection, configures lazy loading, optimizes bundle size with tree shaking, and applies trackBy in ngFor loops'.
Expand trigger terms to include natural phrases users would say, such as 'slow Angular app', 'change detection strategy', 'lazy loading', 'AOT compilation', 'zone.js optimization'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Angular performance optimization) and mentions some areas (bundle size, rendering efficiency), but doesn't list specific concrete actions like 'configure lazy loading', 'implement OnPush change detection', or 'tree-shake unused modules'. | 2 / 3 |
Completeness | Clearly answers both 'what' (Angular performance optimization and best practices guide) and 'when' (Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency) with an explicit 'Use when...' clause. | 3 / 3 |
Trigger Term Quality | Includes relevant terms like 'Angular', 'performance', 'bundle size', 'rendering efficiency', 'refactoring', but misses common natural variations users might say such as 'slow Angular app', 'change detection', 'lazy loading', 'AOT compilation', 'trackBy', or 'zone.js'. | 2 / 3 |
Distinctiveness Conflict Risk | The Angular focus provides some distinctiveness, but 'performance optimization' and 'best practices guide' are broad enough to potentially overlap with general Angular development skills or generic web performance optimization skills. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured Angular performance guide with excellent actionability — every recommendation includes executable CORRECT/WRONG code examples. Its main weaknesses are length (could benefit from splitting into referenced sub-files) and the absence of verification/measurement steps for performance optimizations. The content is accurate and covers modern Angular patterns (signals, zoneless, incremental hydration) comprehensively.
Suggestions
Add verification steps for key optimizations (e.g., 'Run `ng build --stats-json` and check bundle analyzer to confirm lazy loading is working', 'Use Angular DevTools profiler to verify OnPush reduces change detection cycles').
Split detailed sections (SSR, Bundle Optimization, Rendering) into separate referenced files to reduce the main SKILL.md to a concise overview with links, improving progressive disclosure.
Remove the 'When to Use' section and 'Limitations' boilerplate — these are obvious from context and waste tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~400 lines) and includes some unnecessary framing (e.g., 'When to Use' section listing obvious triggers, the priority table that restates what the headers already convey, and the 'Limitations' boilerplate). However, the code examples themselves are lean and the CORRECT/WRONG pattern is efficient. Some sections like the 'Benefits' list for zoneless could be trimmed. Overall mostly efficient but could be tightened. | 2 / 3 |
Actionability | Every section provides fully executable, copy-paste-ready TypeScript and HTML code with clear CORRECT/WRONG contrasts. The examples are concrete, use real Angular APIs, and cover specific patterns like forkJoin, switchMap, @defer, virtual scrolling, TransferState, and takeUntilDestroyed. The checklists at the end are directly actionable. | 3 / 3 |
Workflow Clarity | This is primarily a reference/best-practices guide rather than a multi-step workflow, so explicit sequencing is less critical. However, the skill lacks validation checkpoints — there's no guidance on how to verify that optimizations are working (e.g., measuring bundle size, profiling change detection cycles, checking hydration). For a performance optimization guide, verification steps would be valuable and their absence caps this at 2. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear headers and a priority table, but it's a monolithic ~400-line file with no bundle files to offload detailed sections. The SSR, state management, and rendering sections could each be separate referenced files. The external resource links at the bottom are helpful but the inline content is heavy for a single SKILL.md. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (564 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
0839f85
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.