CtrlK
BlogDocsLog inGet started
Tessl Logo

angular-best-practices

Angular performance optimization and best practices guide. Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency.

64

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/antigravity-angular-best-practices/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a model of token-efficient progressive disclosure: a lean overview that delegates cleanly to a single, well-organized, one-level-deep reference. The trade-off is that the body carries almost no actionable content of its own — everything executable lives behind the reference pointer.

Suggestions

Add a short 'Top rules' quick-start with the 2-3 highest-priority items (e.g., OnPush change detection, eliminating sequential fetches) so trivial questions are answerable without loading the 549-line guide.

Name the guide's checklists in the workflow — e.g., 'When reviewing code, run the Performance Review checklist in the guide' — so the reader knows which artifact to apply per task type.

Move the 'When to Use' bullet list into the description frontmatter phrasing or trim bullets that duplicate it, since the description already covers most of the same triggers.

DimensionReasoningScore

Conciseness

The ~25-line body is lean with zero padding: no Angular tutorials, no explanation of concepts Claude already knows, and each sentence does work ('For focused work, load the relevant sections; for end-to-end work, read the guide completely.'). This matches the 'lean and efficient; every token earns its place' anchor — the bulk of the material is correctly pushed to the reference file.

5 / 5

Actionability

The body's only executable instruction is 'Read [the detailed guide](references/detailed-guide.md) before executing this skill' — the pointer is concrete and the file is real, but the body itself contains no code, commands, or even one inline rule a reader could apply without opening the reference. This lands at 'some concrete guidance but incomplete': the delegation is clean, yet a quick-start snippet or the top critical rule inline would make the body self-sufficient for simple cases.

3 / 5

Workflow Clarity

The sequence is clear and unambiguous for a reference-consultation skill: check 'When to Use' scope, read the guide (fully or by section), apply the prioritized rules. Not a 5 because the body never tells the reader how to act on the guide's own artifacts — e.g., the guide contains 'Performance Review' and 'SSR Check' checklists that the body could invoke by name for review tasks, and no validation/verification step is mentioned (not required here since nothing is destructive or batch).

4 / 5

Progressive Disclosure

Scored against the actual bundle: the body is a concise overview pointing to exactly one reference, references/detailed-guide.md, which exists, is one level deep (it links only to external angular.dev URLs, no nested bundle files), and is well-sectioned with a priority-ordered category structure that supports the body's 'load the relevant sections' instruction. This matches the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

17

/

20

Passed

Description

73%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description with an explicit 'Use when...' clause, natural trigger terms, and a distinct Angular-performance niche. Its main weakness is that the stated capabilities never get concrete — 'optimization' and 'best practices' do the work that specific actions (lazy loading, waterfall elimination, hydration tuning) should do.

Suggestions

Replace 'performance optimization and best practices' with 2-3 concrete capabilities, e.g., 'Eliminates data-fetching waterfalls, lazy-loads routes, and configures SSR/hydration for Angular apps.'

Mirror the skill's own 'When to Use' triggers in the description — add 'data fetching', 'SSR/hydration setup', and 'bundle/load-time issues' so users searching those phrases match this skill.

DimensionReasoningScore

Specificity

The description names the domain ('Angular performance optimization and best practices guide') and the optimization axes ('optimal performance, bundle size, and rendering efficiency'), but the actions themselves are generic — 'writing, reviewing, or refactoring' — with no concrete capabilities like lazy-loading routes, eliminating data waterfalls, or configuring SSR hydration. It sits between 'names domain with 1-2 concrete actions' (3) and 'several specific actions' (4): more specific than a bare domain mention, but the action verbs never rise above generic.

3 / 5

Completeness

Both parts are explicit: the 'what' ('Angular performance optimization and best practices guide') and a clear 'Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency' clause. Not a 5 because the 'what' stays at the level of 'optimization and best practices' rather than concrete capabilities, and the 'when' omits several task triggers the skill actually covers (data fetching, SSR/hydration configuration).

4 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'Angular', 'performance', 'bundle size', 'refactoring', 'reviewing', 'rendering'. Not a 5 because common variations are missing — e.g., 'slow app', 'load times', 'SSR/hydration', 'change detection' — terms that appear in the skill's own 'When to Use' section but not in the description.

4 / 5

Distinctiveness Conflict Risk

The 'Angular' qualifier plus the performance/bundle/rendering focus carves out a clear niche with distinct triggers; the only overlap risk is a hypothetical general Angular style skill, which the performance framing still separates. This matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
boisenoise/skills-collections
Reviewed

Table of Contents

Is this your skill?

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.