CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

78%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/angular-best-practices/SKILL.md

The canonical home for this skill is angular-best-practices in sickn33/agentic-awesome-skills

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.

A highly actionable, well-prioritized rules guide with excellent CORRECT/WRONG code examples and useful checklists. Its main weaknesses are the fully inlined ~550-line body with no progressive disclosure into reference files, a duplicated filler 'When to Use' section, and the absence of measurement/verification steps in the review workflow.

Suggestions

Split the eight detailed rule categories into references/ files (e.g. references/change-detection.md, references/bundle-optimization.md) and keep SKILL.md as a lean overview with the priority table, checklists, and clearly signaled one-level-deep links.

Delete the duplicated trailing '## When to Use' section and its filler sentence ('This skill is applicable to execute the workflow or actions described in the overview.') — the real When-to-Use content already exists near the top.

Add explicit verification steps to the review workflow, e.g. 'confirm with source-map-explorer that the route is no longer in the main bundle' or 'profile change detection cycles before/after', so applied rules come with feedback loops.

DimensionReasoningScore

Conciseness

The body is dominated by tight CORRECT/WRONG code pairs with no basic-concept padding (no 'what is Angular' or library tutorials), so most tokens earn their place. It falls short of anchor 5 because of the duplicated 'When to Use' section at the end containing pure filler ('This skill is applicable to execute the workflow or actions described in the overview.') and some redundant WRONG examples that could be trimmed.

4 / 5

Actionability

Every rule ships copy-paste-ready, executable TypeScript/HTML using concrete APIs (forkJoin/switchMap, @defer with hydration triggers, track expressions, provideZonelessChangeDetection, TransferState, takeUntilDestroyed), plus concrete checklists. This matches the anchor for fully executable, common-case-covering guidance.

5 / 5

Workflow Clarity

The priority table (CRITICAL → LOW-MEDIUM) sequences where to attack first, and the three checklists (New Component, Performance Review, SSR Check) act as validation checkpoints. It is not a 5 because there is no explicit apply/review workflow with verification steps such as measuring the bundle (source-map analysis) or profiling change detection before and after applying rules.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all ~550 lines of detailed rules are inlined in SKILL.md. Internal structure is good (clear sections and a priority table), but content that clearly belongs in separate reference files — e.g. the eight detailed rule categories — is inline with no pointers to deeper material, matching anchor 3 rather than 4.

3 / 5

Total

16

/

20

Passed

Description

70%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 solid description with an explicit and specific 'Use when' clause and natural Angular performance triggers. Its main weakness is a generic 'what' side — 'best practices guide' doesn't state the concrete capabilities the skill actually delivers.

Suggestions

Replace 'best practices guide' with the concrete capabilities the skill covers, e.g. 'Eliminates change-detection and async-waterfall bottlenecks, lazy-loads routes and bundles, and configures SSR/hydration for Angular apps.'

Add natural trigger synonyms users would say, such as 'slow Angular app', 'reduce bundle size', or 'Angular code review'.

Keep the description in third person (it currently is) and trim the vague 'best practices' phrasing to avoid triggering for non-performance Angular tasks like styling or testing.

DimensionReasoningScore

Specificity

The description names the domain ('Angular performance optimization') with 1-2 actions ('optimization', 'best practices guide'), but 'best practices' is generic buzzword-level language rather than a list of concrete capabilities. It matches anchor 3 (domain and 1-2 concrete actions, not comprehensive), not 4, which requires several specific actions such as 'eliminates async waterfalls, lazy-loads routes, configures SSR hydration'.

3 / 5

Completeness

Both parts are explicitly present: the what ('Angular performance optimization and best practices guide') and an explicit when ('Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency'). It fits anchor 4 rather than 5 because the what-side leans generic ('best practices guide') instead of concretely stating what the skill contains.

4 / 5

Trigger Term Quality

'writing, reviewing, or refactoring Angular code', 'bundle size', and 'rendering efficiency' are natural phrases users would say, giving good keyword coverage. It falls short of anchor 5 because common variations like 'slow Angular app', 'make it faster', 'lazy loading', or 'change detection' are missing.

4 / 5

Distinctiveness Conflict Risk

'Angular' carves out a clear niche with distinct triggers, so it is mostly distinguishable from other skills. However, 'best practices' breadth means it could also trigger for non-performance Angular tasks (styling, testing, architecture), which is minor overlap risk — anchor 4, not 5.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (563 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/angular-best-practices/SKILL.md

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.