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 marks. It provides specific capabilities, comprehensive trigger terms covering natural user language, explicit 'Use when' and 'Do NOT use' clauses, and clear boundaries distinguishing it from related skills. The inclusion of negative triggers for disambiguation is a particularly strong feature.

DimensionReasoningScore

Specificity

Lists concrete actions: 'designing and building high-quality skills from scratch through structured conversation.' Also specifies coverage of 'standalone skills and MCP-enhanced workflows' and explicitly distinguishes from related but different tasks (subagents, technical design docs).

3 / 3

Completeness

Clearly answers both 'what' (guide for 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 address potential conflicts. The niche of skill creation/design is well-defined and unlikely to overlap with other skills.

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 guide for building skills through a phased conversation approach. Its greatest strengths are the clear multi-phase workflow with explicit exit criteria and the concrete, actionable guidance throughout. The main weakness is moderate verbosity — the Core Philosophy section and some explanatory prose could be trimmed without losing clarity, as the agent doesn't need motivational framing to follow instructions.

Suggestions

Trim or remove the 'Core Philosophy' section — these are design rationales for humans, not actionable instructions for an agent. Fold any critical points into the relevant workflow phases as brief inline notes.

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. Overall mostly efficient but not maximally lean.

2 / 3

Actionability

The skill provides highly concrete, actionable guidance: specific folder structures, exact YAML frontmatter format with hard rules, template structures for use cases and descriptions, explicit exit criteria checklists for each phase, anti-pattern lists, and concrete examples of what to write. The guidance is specific enough to follow without ambiguity.

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. Validation includes structural checks, trigger testing, and instruction quality review with clear feedback loops ('If issues exist, fix them before delivery'). The workflow is well-structured with no ambiguity about ordering or dependencies.

3 / 3

Progressive Disclosure

The skill explicitly practices what it preaches about progressive disclosure. It references external files appropriately (references/patterns.md, references/examples.md, references/quality-checklist.md, scripts/validate_skill.py) with clear guidance on when to consult them. The three-level disclosure system (L1/L2/L3) is well-documented and the SKILL.md body stays focused on the core workflow.

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.