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
73%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/common/common-skill-creator/SKILL.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
3df717f
Table of Contents
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.