CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-architect

Create, audit, and refactor portable agent skills (`SKILL.md`). Use when asked to "create a skill", "review a skill", "improve a skill", "author a skill", "refactor a skill", "compare skill rubrics", "distill a skill from sessions", "reconcile skill plans", or "teach skill authoring"; when paths include `skills/<name>/SKILL.md`, `references/*.md`, helper scripts, evals, lockfiles, security manifests, or vendor adapters; or when mentions include skill-creator, Skill Development, skills.sh, trigger descriptions, progressive disclosure, skill evals, completion criteria, leading words, repository gates, or model/user invocation.

Quality

90%

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

85%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-engineered body: executable mode routing, completion criteria on every step, dry-run-first fix loops, and a clean one-level-deep reference structure that matches the actual bundle. The residual costs are structural duplication between the two parallel step frameworks and the absence of a single complete inline helper invocation.

Suggestions

Inline one complete example invocation (e.g. `python -E -B assets/scripts/validate_skill.py <skill-folder>`) in the Helper scripts section so the most common verification action is executable without opening helper-runtime.md.

Merge or cross-reference the "Operating mode" seven-step order with the "Skill architecture workflow" steps to eliminate the duplicated classify/plan/verify guidance.

Consolidate the audit-packet table and the predictability-pass list, which repeat several checks (completion criteria, leading words, pruning/sediment) across two formats.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence ("Patch narrowly — avoid churn-only rewrites", terse mode/layer tables) with no padding or explanation of known concepts, so it is above anchor 3. It stays at 4 rather than 5 because the seven-step "Operating mode" order substantially duplicates the "Skill architecture workflow" (classify/gather, plan artifact, verify mechanically/verify and hand off), and verification emphasis repeats across three sections — trims are available, though minor.

4 / 5

Actionability

Concrete guidance throughout: exact script names and flags (`fix_skill.py --write`, `--author`, `--openai-yaml`, `python -E -B`), a mode table with per-mode references and outputs, and a layer table routing each check to its decider. It is not 5 because no complete verbatim invocation appears in the body — exact commands are deferred to references/helper-runtime.md, leaving a minor gap for the most common validation action.

4 / 5

Workflow Clarity

Every ordered step carries a checkable "Done when" completion criterion, fix mode is explicitly dry-run-first with a validate-after feedback loop ("only apply `fix_skill.py --write` ... then run `validate_skill.py`"), the audit packet is a per-check decision table, and reporting demands "exactly what passed, failed, or was skipped". This is the anchor-5 pattern: explicit validation, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

SKILL.md stays routing-focused ("Keep `SKILL.md` focused on routing and immediate behavior") while all detail lives in one-level-deep, real bundle files: the six references are linked via a "Load when" table, all five helper scripts plus requirements.txt are linked with use descriptions, and assets/evals/scenarios.json is disclosed as test input — every referenced path exists in the bundle. Navigation is easy and well-signaled, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

95%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: third-person, verb-led, with an explicit Use-when clause covering natural request phrases, path patterns, and mention keywords. The only weakness is that the capability clause names three of the nine supported modes, leaving the full functional breadth to be inferred from trigger phrases.

DimensionReasoningScore

Specificity

"Create, audit, and refactor portable agent skills (`SKILL.md`)" names three concrete actions with a concrete artifact, but the capability clause omits the plan, compare, distill, reconcile, and teach modes that the body implements — those surface only as trigger phrases. This matches anchor 4 (several specific actions, minor gaps in coverage) rather than 5, whose capability coverage would be comprehensive.

4 / 5

Completeness

Explicitly answers both questions: the "what" is "Create, audit, and refactor portable agent skills (`SKILL.md`)" and the "when" is a full "Use when asked to..." clause with concrete trigger phrases plus path- and mention-based triggers. This is a clear anchor-5 match; it is not 4 because the when-clause is maximally explicit, not merely present.

5 / 5

Trigger Term Quality

Extensive natural trigger phrases with synonyms and file-level detail: "create a skill", "review a skill", "improve a skill", "compare skill rubrics", "distill a skill from sessions", path triggers like `skills/<name>/SKILL.md`, `references/*.md`, lockfiles, security manifests, and mention triggers like skill-creator, skills.sh, and progressive disclosure. Coverage of natural terms is comprehensive, matching the anchor-5 example's breadth.

5 / 5

Distinctiveness Conflict Risk

The niche (authoring/auditing portable agent skills) is distinct, anchored by triggers like `skills/<name>/SKILL.md`, skill rubrics, lockfiles, and progressive disclosure that few other skills would claim. The deliberate "skill-creator" mention trigger overlaps a closely related skill, but it is scoped to comparing/auditing upstream rubrics — the closest anchor is still 5, not 4, since overall conflict risk is minimal and domain-unique.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 7 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 13 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

t4sh/skills4sh

Path

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