CtrlK
BlogDocsLog inGet started
Tessl Logo

north-star

Constitutional source of truth for reusable Plate architecture and public API design. Use when introducing or changing reusable public APIs, runtime/service boundaries, builder or factory patterns, extension registration contracts, naming/layering rules, or performance-sensitive architecture.

57

Quality

68%

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 ./.agents/skills/north-star/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

52%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 well-organized routing doctrine with a clear workflow, a concrete checklist, and an unusually disciplined deferral of detail to reference files — but the referenced files do not exist, so the skill's actual substance is unreachable. Combined with significant repetition across the four routing sections, the skill reads as the skeleton of a strong artifact missing its meat.

Suggestions

Ship the six referenced ./rules/*.md files (laws, decision-ladder, performance-selection-rules, update-policy, pattern-catalog, anti-patterns) or inline their essential rules — every 'Run the...' workflow step currently dead-ends.

Collapse the overlapping routing sections ('Use When', 'Do Not Use When', 'Hard Routing Rule', 'Routing Matrix', 'Who Owns What') into the Routing Matrix plus one short do-not-use list; they restate the same decision three to four times.

Cut or rewrite 'Best Mix' (it lists ProseMirror/Lexical/Portable Text with one-line glosses whose actionable meaning is unclear) and trim 'Final Law', which is rhetorical restatement.

DimensionReasoningScore

Conciseness

The body is mostly tight doctrine language with no education of concepts Claude already knows, but it restates the same routing decision three to four times ('Use When', 'Do Not Use When', 'Hard Routing Rule', 'Routing Matrix', 'Who Owns What'), and the 'Best Mix' and 'Final Law' sections are cryptic or rhetorical padding. That is 'some unnecessary explanation / could be tightened' rather than the several padded sections of a 2.

3 / 5

Actionability

The matcher-extraction heuristic, reaffirmation strings ('north-star reaffirmed: laws'), and binary review checklist are genuinely concrete, instruction-only guidance. But the workflow's substance is delegated to six ./rules/*.md files ('Run the decision ladder', 'Check the pattern catalog') that do not exist in the bundle, so key executable detail is missing rather than merely incomplete in the way anchor 4's 'minor gaps' implies.

3 / 5

Workflow Clarity

An 8-step numbered workflow gives a clear sequence with the binary review checklist and the reaffirmation contract acting as explicit checkpoints. Not 5 because there is no error-recovery guidance (what to do when two ladder rungs conflict, or when a pattern matches both core and feature ownership) and because half the steps resolve to missing files.

4 / 5

Progressive Disclosure

The body correctly defers detail to one-level-deep, clearly labeled references (Constitutional Layer, Pattern Layer, workflow steps), which is the right structure — but all six referenced files (laws.md, decision-ladder.md, performance-selection-rules.md, update-policy.md, pattern-catalog.md, anti-patterns.md) are absent from the bundle, so every deep link is broken and navigation dead-ends. That is broken navigation, not the minor organization gaps of a 4 or the merely 'not clearly signaled' references of a 3.

2 / 5

Total

12

/

20

Passed

Description

83%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 strong description: it names a precise niche and pairs it with an explicit, multi-trigger 'Use when' clause covering the main invocation scenarios. Minor improvements would be replacing the somewhat abstract 'source of truth' framing with a concrete capability verb and adding one or two synonym trigger phrases.

DimensionReasoningScore

Specificity

The description lists several specific scope areas — 'reusable public APIs, runtime/service boundaries, builder or factory patterns, extension registration contracts, naming/layering rules, or performance-sensitive architecture' — which is well beyond a bare domain claim. It stops short of 5 because 'Constitutional source of truth' is a role statement rather than a concrete capability, and no actual design actions are named.

4 / 5

Completeness

Both halves are explicit: the what ('Constitutional source of truth for reusable Plate architecture and public API design') and an explicit 'Use when...' clause enumerating concrete trigger scenarios. The when-clause is specific and multi-triggered, matching the anchor-5 example's shape; it does not fall to 4 because the when is not weak or under-specified.

5 / 5

Trigger Term Quality

Terms like 'public API', 'builder or factory patterns', 'extension registration', 'runtime/service boundaries', and 'performance-sensitive architecture' are natural phrasings a user working on Plate would say. Not 5 because there are no synonyms or variants (e.g. 'plugin architecture', 'API contract', 'refactoring a public surface'), though file extensions don't apply to this kind of design skill.

4 / 5

Distinctiveness Conflict Risk

The niche (reusable Plate architecture doctrine) is clearly distinct from plugin-authoring execution, and the triggers are architecture-level rather than generic. Not 5 because 'performance-sensitive architecture' and 'introducing or changing reusable public APIs' are broad enough to occasionally overlap with a general architecture or performance skill; the body's explicit handoff boundary to the execution companion is not visible in the description alone.

4 / 5

Total

17

/

20

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 — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 12 missing, 6 suspicious

Warning

Total

13

/

16

Passed

Repository
udecode/plate
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.