CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-recipe

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

63

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/add-recipe/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

96%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 an exemplary terse procedural skill: dense, repo-specific knowledge delivered as imperative rules with concrete commands, examples, stop conditions, and validation loops at every stage. Its only structural refinement would be splitting the authentication and icon rule blocks into a bundled reference to slim the main file further.

DimensionReasoningScore

Conciseness

The body is lean and declarative throughout ("Swagger 2.0 fails.", "Standalone SSE and stdio servers fail.", "Done when you hold at least one usable source URL"), with no explanation of concepts Claude already knows and every sentence carrying non-obvious domain rules. It matches the level-5 anchor 'lean and efficient; assumes Claude's competence; every token earns its place'.

5 / 5

Actionability

Guidance is copy-paste executable: exact commands ("npx vitest run --project server recipes.server", "npm run check --prefix apps/reef", "./dev run"), exact file paths, a URL pattern for live testing, and a warning against a broken command ("Do not use `npm test -- recipes.server`"). Concrete examples (linear, github, sentry, hubspot, attio) anchor each decision rule, matching the level-5 anchor for fully executable, ready guidance.

5 / 5

Workflow Clarity

Six clearly sequenced numbered sections with explicit checkpoints and feedback loops: a stop-and-ask gate for existing ids, 'Done when' criteria in sections 2 and 4, a plan-then-wait-for-approval gate before writing, and 'Run, and fix until both pass' plus direct source verification (fetch the URL, POST an initialize request). This matches the level-5 anchor of clear sequencing with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

The skill ships no bundle files and keeps the body well-sectioned, pushing detail to one-level-deep repo artifacts clearly signaled up front (GLOSSARY.md, ADRs, schema.json, example recipes, docs/development.md). It falls short of level 5 because sizable decision-rule blocks (the seven authentication rules and the icon/light-dark variant guidance) are fully inlined and could live in a small reference file, and there are no bundled references of its own.

4 / 5

Total

19

/

20

Passed

Description

53%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, concrete 'what' with a well-defined artifact and destination, but omits any 'when to use' trigger guidance and offers only two actions without natural synonyms users might say. It is distinct within its niche yet reads more like a command summary than a fully self-describing skill description.

Suggestions

Add an explicit trigger clause such as 'Use when the user asks to add or integrate a new upstream service/provider (e.g. notion, linear) into Reef.' to satisfy the missing 'when'.

Enumerate a few more concrete actions to raise specificity, e.g. 'research its OpenAPI/MCP source, choose authentication methods and scopes, pick icons, and write recipe.yaml'.

Include natural user-facing synonyms like 'add a provider', 'new integration', or 'recipe for <service>' to broaden trigger term coverage.

DimensionReasoningScore

Specificity

The description names two concrete actions ("Research an upstream service" and "write a Provider Recipe for it in apps/reef/recipes") with a concrete artifact and location, matching the 'names domain and 1-2 concrete actions' anchor. It does not list the several specific actions a recipe involves (auth methods, sources, icons), so it falls short of the level-4 anchor 'lists several specific actions'.

3 / 5

Completeness

The 'what' is clear (research a service, write a Provider Recipe at a specific path), but there is no 'Use when...' or equivalent trigger guidance, capping completeness at 3 per the judging guidelines. Level 4 requires both 'what' and an explicit 'when'; level 2 would require a vague 'what', which does not apply.

3 / 5

Trigger Term Quality

Relevant keywords are present ("Research", "upstream service", "Provider Recipe", "recipes") but common variations a user might say are missing (e.g. "add a provider", "integrate a service", "new integration"). This fits the level-3 anchor 'some relevant keywords but missing common variations or synonyms' rather than level 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The artifact-specific terms "Provider Recipe" and "apps/reef/recipes" carve out a clear niche with minimal overlap risk. It is not quite level 5 because "Research an upstream service" is somewhat generic on its own and the description lacks distinct trigger phrases, leaving minor overlap risk with research-oriented skills.

4 / 5

Total

13

/

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.