CtrlK
BlogDocsLog inGet started
Tessl Logo

common-skill-creator

Standardizes the creation and evaluation of high-density Agent Skills (Claude, Cursor, Windsurf). Ensures skills achieve high Activation (specificity/completeness) and Implementation (conciseness/actionability) scores. Use when: writing or auditing SKILL.md, improving trigger accuracy, or refactoring skills to reduce redundancy and maximize token ROI.

61

Quality

73%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/common/common-skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 a solid description with explicit 'Use when' triggers and a clearly distinct niche. Its main weakness is that the capability descriptions lean slightly abstract ('standardizes', 'ensures') rather than listing granular concrete actions. The trigger terms are well-chosen and the completeness is strong with the explicit trigger clause.

Suggestions

Replace abstract verbs like 'standardizes' and 'ensures' with more concrete actions, e.g., 'Generates frontmatter YAML, writes description fields, scores skills against activation/implementation rubrics, and identifies trigger gaps.'

DimensionReasoningScore

Specificity

Names the domain (Agent Skills for Claude, Cursor, Windsurf) and some actions (creation, evaluation, auditing, refactoring), but the actions are somewhat abstract—'standardizes creation' and 'ensures skills achieve high scores' are more aspirational than concrete. It doesn't list specific concrete actions like 'writes frontmatter YAML', 'generates description fields', or 'scores against rubric dimensions'.

2 / 3

Completeness

Clearly answers both 'what' (standardizes creation and evaluation of agent skills, ensures high activation and implementation scores) and 'when' with an explicit 'Use when:' clause listing three specific trigger scenarios: writing/auditing SKILL.md, improving trigger accuracy, and refactoring skills.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'SKILL.md', 'trigger accuracy', 'Agent Skills', 'Claude', 'Cursor', 'Windsurf', 'auditing', 'refactoring skills', 'token ROI'. These are terms a user working on skill files would naturally use, with good coverage of variations.

3 / 3

Distinctiveness Conflict Risk

This is a very specific meta-skill about creating and evaluating SKILL.md files for AI agents. The niche is narrow and distinct—it's unlikely to conflict with other skills since it targets skill authoring itself, with specific terms like 'SKILL.md', 'trigger accuracy', and 'Activation/Implementation scores'.

3 / 3

Total

11

/

12

Passed

Implementation

57%

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

This is a well-structured meta-skill with strong progressive disclosure and reasonable conciseness. Its main weaknesses are in actionability (lacking executable examples for key workflows like subagent testing and trigger evaluation) and workflow clarity (missing explicit validation checkpoints and error recovery loops within the numbered steps). The skill practices some of what it preaches but could better demonstrate its own principles.

Suggestions

Add a concrete, executable example of the parallel subagent testing step (steps 4-5) — even a brief command or script invocation — to improve actionability.

Include explicit validation checkpoints in the workflows, e.g., 'If trigger rate < 80%, revisit description wording and re-run eval' as an inline feedback loop rather than deferring entirely to references.

The Anti-Patterns section partially duplicates Content Quality rules (e.g., 'No AI-splaining' restates 'No Redundant Knowledge'). Consolidate to reduce redundancy and improve conciseness.

DimensionReasoningScore

Conciseness

The skill uses 'Caveman Compression' style in places and avoids explaining basic concepts, but it's a meta-skill about writing skills that includes some redundant guidance (e.g., explaining what Activation and Implementation mean, the anti-patterns section partially restates content quality rules). Some tightening is possible.

2 / 3

Actionability

The workflows provide numbered steps and the quality checklist is concrete, but there are no executable code examples or copy-paste-ready commands beyond a single `cp -r` snippet. The 'Caveman Compression' section provides a good before/after example, but most guidance remains descriptive rather than directly executable (e.g., 'spawn parallel subagents' without showing how).

2 / 3

Workflow Clarity

Both new and existing skill workflows are clearly sequenced with numbered steps, which is good. However, there are no explicit validation checkpoints or feedback loops within the steps — step 6 says 'iterate' but doesn't define pass/fail criteria inline. The testing steps reference external docs without summarizing what validation looks like, and destructive operations (editing existing skills) lack explicit rollback guidance beyond a snapshot step.

2 / 3

Progressive Disclosure

Excellent structure with a clear three-level loading system, well-organized sections in the body, and a comprehensive references section with contextual 'load when' hints for each linked file. References are one level deep and clearly signaled with descriptive labels.

3 / 3

Total

9

/

12

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
HoangNguyen0403/agent-skills-standard
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.