CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-foundry

Design, organize, evaluate, benchmark, and improve portable Agent Skills. Use when creating a new skill, deciding whether a workflow deserves a skill, auditing a skill library, comparing a skill against baseline or prior versions, optimizing a skill description for better triggering, or retiring outdated skills across Claude, Codex, ChatGPT-compatible tools, and other Agent Skills-compatible environments.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 well-structured, largely actionable instruction-only skill with a clear sequenced workflow and evidence-gated decisions. Its main weakness is progressive disclosure: the shipped references and templates are orphaned because SKILL.md never names or links them, so Claude reading the skill would not discover the bundle. Minor redundancy between the role list, core principles, and guardrails also costs token efficiency.

Suggestions

Link the shipped bundle files by name at the point of use, e.g. in step 7: "See [description-heuristics.md](references/description-heuristics.md) when optimizing descriptions" and "See [eval-checklist.md](references/eval-checklist.md) when building the test plan".

In the Draft step, reference the actual templates in assets/ (skill-template.md, intake-template.md, eval-plan-template.md, catalog-entry-template.yaml) instead of only the generic "recommended references/" and "recommended assets/" lines.

Trim the opening "Your role" bullet list that duplicates the frontmatter description, and merge overlapping items between "Core principles" and "Guardrails" (e.g., the repeated retirement guidance) to tighten token usage.

DimensionReasoningScore

Conciseness

The body is efficient bullet-based guidance with no explanation of concepts Claude already knows, but the opening "Your role is to help the user" list largely duplicates the frontmatter description, and retire/benchmark guidance recurs across Core principles, workflow step 6, and Guardrails. These minor trimmable redundancies place it at anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete, executable decision rules are present ("Default to no skill needed when the work is clearly one-off", "Choose reviewer when the skill inspects, scores, critiques", kebab-case folder naming, numbered per-mode output structures). It misses anchor 5 mainly because it never points to its own shipped templates in assets/, leaving minor gaps in otherwise specific guidance.

4 / 5

Workflow Clarity

An eight-step workflow (Intake → Decide → Classify → Draft → Evaluate → Benchmark → Optimize → Organize) is clearly sequenced, with an evidence-gated retirement decision ("Retire the skill when baseline consistently wins") and an eval plan that includes negative examples. It falls below anchor 5 because feedback loops (re-test after description or structural fixes) are implied by step ordering rather than explicitly stated.

4 / 5

Progressive Disclosure

The body is well-sectioned and of reasonable length, but it never links to any of the eight real bundle files (references/description-heuristics.md, references/eval-checklist.md, references/anti-patterns.md, references/lifecycle-playbook.md, and four assets/ templates) — only generic directory mentions like "Move bulky details into references/" appear. Since references exist in the bundle but are not signaled or navigable from SKILL.md, this matches anchor 3 rather than anchor 4's "references mostly clear".

3 / 5

Total

15

/

20

Passed

Description

87%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 that clearly states what the skill does and when to use it, with concrete lifecycle triggers and platform scoping in third-person voice. Keyword coverage is good but not exhaustive of natural synonyms, and the capability verbs could be slightly more concrete. No guideline penalties apply (explicit Use-when clause present, no first/second person, no fluff).

DimensionReasoningScore

Specificity

"Design, organize, evaluate, benchmark, and improve portable Agent Skills" names the domain and pairs each action with concrete scenarios ("auditing a skill library", "comparing a skill against baseline or prior versions", "retiring outdated skills"), matching the several-specific-actions anchor. It falls short of 5 because the leading verbs remain somewhat abstract and no concrete output artifacts are named.

4 / 5

Completeness

It explicitly answers both questions: the "what" is "Design, organize, evaluate, benchmark, and improve portable Agent Skills" and the "when" is an explicit "Use when" clause listing six concrete triggers, closely matching the top anchor's example structure. A 4 would require the when-clause to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say include "creating a new skill", "auditing a skill library", "optimizing a skill description", and "retiring outdated skills", plus platform names (Claude, Codex, ChatGPT-compatible). A few natural variants are missing (e.g., "build" or "write a skill", "review my skills"), keeping it below comprehensive synonym-level coverage.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear meta-niche — Agent Skills lifecycle governance — with distinct triggers (skill creation, auditing, benchmarking, retirement) and platform scoping, so it is unlikely to fire for skills that perform ordinary work. It is more distinct than the minor-overlap anchor 4 example because every trigger is scoped to skill management.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

saski/arnesto

Path

.agents/skills/skill-foundry/agents/skills/skill-foundry/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.