CtrlK
BlogDocsLog inGet started
Tessl Logo

expert-sdd-creator

Meta skill for creating new SDD experts from domain documentation. Provide a markdown file path with domain knowledge + optional steering context. Automatically synthesizes references, generates signal scripts, validates, and registers in experts.md/signals.md catalogs. Single-prompt creation with follow-up tweaks. Triggers - create expert, new expert, make expert, expert for, domain expert, add expert (project)

71

Quality

89%

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

86%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 a well-structured, highly actionable overview: executable commands, templates, and a clear 7-step workflow, with details correctly delegated to real one-level-deep reference files. The only improvements are trimming minor command duplication and adding explicit failure-path handling after validation.

DimensionReasoningScore

Conciseness

The body is efficient with no padding or explanations of concepts Claude already knows, but contains minor duplication that could be trimmed: the validate/register commands appear both in step 6 and again in the Signal Mode quick-commands table, and the Expert Structure Requirements section partially restates the step-2 directory tree. This sits above anchor 3 (which would require some unnecessary explanation) but below anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Fully executable guidance throughout: a copy-paste example prompt, a concrete directory structure template, a SKILL.md frontmatter template, a domain-type-to-signal-approach mapping table, and runnable commands such as "scripts/validate_expert.sh /path/to/expert-{name}" and "scripts/register_expert.sh /path/to/expert-{name}". Specific examples cover the common creation case end-to-end, matching anchor 5.

5 / 5

Workflow Clarity

The 7-step creation process is clearly sequenced with an explicit validation checkpoint (step 6: run validation, "If valid, register") and an Expert Structure Requirements checklist. However, the failure path is not explicitly handled — there is no instruction for what to do when validation fails (fix and re-validate), which anchor 5 requires as feedback loops for error recovery.

4 / 5

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep references: all pointers (references/expert-structure.md, references/catalog-formats.md, references/signal-patterns.md) resolve to real bundle files, and detail such as catalog entry formats, structure patterns, and signal script patterns is appropriately split into those files. Navigation is easy with no nesting or buried references, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

88%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 with multiple concrete actions, its input requirements, and an explicit trigger list. The only weaknesses are a few missing natural trigger synonyms (build/generate expert) and slight generic-phrase overlap risk from short triggers like "expert for".

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Automatically synthesizes references, generates signal scripts, validates, and registers in experts.md/signals.md catalogs" — along with the required input format and workflow mode, giving comprehensive coverage of the skill's behavior. It exceeds anchor 4 because the action list covers the full pipeline rather than leaving minor gaps.

5 / 5

Completeness

The "what" is explicit ("creating new SDD experts from domain documentation... synthesizes references, generates signal scripts, validates, and registers") and the "when" is explicit via "Triggers - create expert, new expert, make expert, expert for, domain expert, add expert", which is equivalent explicit trigger guidance, so the missing-'Use when' cap at 3 does not apply. Both questions are answered with concrete trigger phrases, matching anchor 5.

5 / 5

Trigger Term Quality

Trigger list "create expert, new expert, make expert, expert for, domain expert, add expert" provides good natural verb+noun coverage users would actually say. A few natural variations are missing (e.g., "build expert", "generate expert", "SDD expert", "expert from docs"), so it falls short of anchor 5's comprehensive synonym coverage but sits above anchor 3's missing common variations.

4 / 5

Distinctiveness Conflict Risk

The meta-creation niche (creating other SDD experts from domain docs) is clearly distinct from ordinary domain skills. Short generic phrases like "expert for" carry minor overlap risk with general requests mentioning experts, keeping it below anchor 5's minimal-conflict bar, but the risk is limited, so it is above anchor 3.

4 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
tdg-ninja/context-specs-factory-ai
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.