CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-recipe

Research an upstream service and write a Provider Recipe for it in apps/reef/recipes.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 content is an exemplary instruction-only skill: a tightly sequenced six-step workflow with explicit validation checkpoints, approval gates, feedback loops, and copy-paste commands, delegating all reference detail to well-signaled repo files. It is lean, assumes Claude's competence, and adds only project-specific knowledge.

DimensionReasoningScore

Conciseness

The body is dense, project-specific decision rules with zero padding — "Swagger 2.0 fails", "Standalone SSE and stdio servers fail", "Do not use `npm test -- recipes.server`. It also runs the Storybook tests, which match no file and exit 1" — and it assumes competence, never explaining OpenAPI, MCP, YAML or testing basics. Every token earns its place, matching anchor 5 rather than 4, which would require instances of over-explanation to trim.

5 / 5

Actionability

Fully actionable throughout: copy-paste commands (`npm ci --prefix apps/reef`, `npx vitest run --project server recipes.server`, `npm run check --prefix apps/reef`), an exact id pattern (`[a-z][a-z0-9_]*`), an exact schema header line, precise source checks ("Confirm a 200 with no redirect, and an `openapi` field of `3.0.x` or `3.1.x`"), and exact live-test steps with a concrete URL. As an instruction-only skill with concrete, specific guidance, it meets anchor 5; there are no pseudocode stand-ins or missing key details that would drop it to 4.

5 / 5

Workflow Clarity

Six clearly sequenced sections with explicit checkpoints — "Done when you hold at least one usable source URL", an approval gate ("Show the user a short plan and wait for their approval"), a test-fix feedback loop ("Run, and fix until both pass"), and direct per-source verification steps. This matches anchor 5 (explicit validation, feedback loops); the recipe-writing task is not destructive or batch, so the workflow-clarity cap does not apply.

5 / 5

Progressive Disclosure

The body is a workflow overview that delegates all format and design detail to clearly signaled, one-level-deep references: `GLOSSARY.md` (the Provider Recipe entry), ADRs 0002-0004, `apps/reef/recipes/schema.json` ("Its `description` fields are the field docs"), and example recipes (`linear`, `github`, `sentry`) each annotated with what it demonstrates. No bundle files exist to inline, the references are not nested, and reusing existing repo docs instead of duplicating them matches anchor 5's well-signaled, easy-to-navigate structure.

5 / 5

Total

20

/

20

Passed

Description

57%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.

The description states a clear, distinctive "what" anchored to a concrete artifact and location, but omits any "when to use this" trigger guidance and lacks the natural keyword variations (add a recipe, new provider, integrate a service) that would help invocation. It is a precise but incomplete description.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to add or update a provider recipe for a service (e.g. Notion, Linear, Sentry)."

Include natural synonyms users would actually say — "add a recipe", "new provider", "integrate a service" — alongside the formal term "Provider Recipe".

Sharpen what the research step covers, e.g. "locate its OpenAPI document or MCP server and determine its authentication methods", to raise specificity from two vague-level actions to several concrete ones.

DimensionReasoningScore

Specificity

Names the domain and two actions — "Research an upstream service" and "write a Provider Recipe for it in apps/reef/recipes" — but "research" is generic and the coverage of what the skill actually does is not comprehensive. Anchor 3 fits best: 1-2 concrete actions with gaps, rather than the several specific actions required for 4.

3 / 5

Completeness

The "what" is clear (research a service, write a recipe, where it lives), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"Provider Recipe", "upstream service" and "apps/reef/recipes" are relevant niche terms, but natural variations a user would say ("add a recipe", "new provider", "integrate a service", service names like Notion) are missing. This matches anchor 3 — some relevant keywords, missing common variations or synonyms — rather than 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Provider Recipe for it in apps/reef/recipes" names a highly specific artifact, format and location — a clear niche with minimal conflict risk against any other skill. It matches anchor 5 exactly; anchor 4's "minor overlap risk with closely related skills" does not apply since no plausible competing skill shares these triggers.

5 / 5

Total

14

/

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

withcoral/coral

Path

.agents/skills/add-recipe/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.