CtrlK
BlogDocsLog inGet started
Tessl Logo

ark-architecture

Design architecture for Ark features following existing patterns and principles. Use when planning new features, extending components, or evaluating technical approaches.

95

1.11x
Quality

Does it follow best practices?

Impact

95%

1.11x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

A compact, well-structured instruction skill that stays lean, gives concrete conventions and a clear sequenced workflow, and is appropriately organized for its small scope. It scores full marks across all content dimensions.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it avoids explaining concepts Claude already knows and every line is direct guidance with no padding.

3 / 3

Actionability

Concrete conventions ('Use `?watch=true` query param for SSE streaming', 'Use named ports (e.g., `port: mcp`)') and a specific output template give actionable, copy-ready guidance even without code, which is appropriate for an instruction-only skill.

3 / 3

Workflow Clarity

A clearly sequenced five-step Process is laid out explicitly; this is a design/planning skill rather than a destructive or batch operation, so the absence of validation checkpoints does not cap the score.

3 / 3

Progressive Disclosure

Under 50 lines and single-purpose, it is organized into clear sections (Process, Principles, Conventions, Output) with no bundle files needed, satisfying the simple-skill allowance for a top score.

3 / 3

Total

12

/

12

Passed

Description

90%

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 that covers what the skill does and when to use it with natural trigger terms and a distinct Ark-scoped niche. Its only weakness is that the capability statement stays somewhat abstract rather than listing multiple concrete actions.

DimensionReasoningScore

Specificity

Names the domain ('Design architecture for Ark features') and a guiding approach ('following existing patterns and principles') but the stated actions are high-level rather than a comprehensive list of concrete actions; it stops short of enumerating multiple specific operations.

2 / 3

Completeness

It explicitly answers both 'what' (design Ark architecture following existing patterns) and 'when' (an explicit 'Use when...' trigger clause), satisfying both halves of the completeness criterion.

3 / 3

Trigger Term Quality

The 'Use when planning new features, extending components, or evaluating technical approaches' clause supplies natural phrases a user would actually say when reaching for this skill, giving good trigger coverage.

3 / 3

Distinctiveness Conflict Risk

Scoping to 'Ark features' gives it a clear niche with distinct triggers, making it unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
mckinsey/agents-at-scale-ark
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.