CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-architect

Expert guide for designing and building high-quality skills from scratch through structured conversation. Use when someone wants to create a new skill, build a skill, design a skill, or asks for help making Agents do something consistently. Also use when someone says "turn this into a skill", "I want to automate this workflow", "how do I teach my Agent to do X", or mentions creating SKILL.md files. Covers standalone skills and MCP-enhanced workflows. Do NOT use for creating subagents (use subagent-creator) or technical design documents (use create-technical-design-doc).

94

Quality

92%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that hits all the key criteria. It provides specific actions, comprehensive natural trigger terms, explicit 'Use when' and 'Do NOT use' clauses, and clear boundaries distinguishing it from related skills. The inclusion of both positive triggers and negative exclusions makes it particularly effective for skill selection in a large collection.

DimensionReasoningScore

Specificity

Lists concrete actions: 'designing and building high-quality skills from scratch through structured conversation', covers 'standalone skills and MCP-enhanced workflows', and explicitly distinguishes from subagent creation and technical design docs.

3 / 3

Completeness

Clearly answers both 'what' (designing and building skills through structured conversation, covering standalone and MCP-enhanced workflows) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios, plus a 'Do NOT use' clause for disambiguation).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms: 'create a new skill', 'build a skill', 'design a skill', 'turn this into a skill', 'automate this workflow', 'teach my Agent to do X', 'SKILL.md files'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit negative boundaries ('Do NOT use for creating subagents... or technical design documents') that directly name competing skills, making it very unlikely to conflict with similar skills in the same collection.

3 / 3

Total

12

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality skill that provides a comprehensive, well-structured methodology for building skills. Its greatest strengths are the clear five-phase workflow with explicit exit criteria and the concrete, actionable guidance throughout (folder structures, YAML rules, anti-patterns). The main weakness is moderate verbosity — the Core Philosophy section and some conversational guidance could be trimmed without losing clarity, though the overall token cost is reasonable given the complexity of the task.

DimensionReasoningScore

Conciseness

The skill is well-structured but includes some unnecessary philosophical preamble ('Core Philosophy' section) and verbose explanations that an LLM agent would already understand. The tables and checklists are efficient, but sections like 'Conversation Style' and some Discovery guidance could be tightened. It's not egregiously padded but has room for trimming.

2 / 3

Actionability

The skill provides highly concrete, actionable guidance: specific YAML frontmatter format with hard rules, exact folder structures, template structures for use cases and descriptions, explicit exit criteria for each phase, anti-pattern lists, and validation checklists. The instructions are specific enough that an agent could follow them step-by-step.

3 / 3

Workflow Clarity

The five-phase workflow (Discovery → Architecture → Craft → Validate → Deliver) is clearly sequenced with explicit exit criteria checkboxes at each phase boundary. The Validate phase includes structural validation, trigger testing, and instruction quality review as verification steps. The 'never skip Discovery' rule and feedback loops (fix before delivery) are well-defined.

3 / 3

Progressive Disclosure

The skill practices what it preaches: the SKILL.md body contains the core workflow while referencing external files (references/patterns.md, references/examples.md, references/quality-checklist.md, scripts/validate_skill.py) with clear conditions for when to consult them. The three-level disclosure system (frontmatter → body → linked files) is explicitly taught and modeled.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-skills
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.