bapfernandez/test-publish
A realistic Express app with a multilingual greeting API and frontend, powered by a hello-world skill
30
Does it follow best practices?
Validation for skill structure
Discovery
0%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 description fails on all dimensions as it describes the skill's development purpose rather than its functional capabilities. It provides no actionable information for Claude to determine when to select this skill, contains no user-facing trigger terms, and would be indistinguishable from any other test or placeholder skill.
Suggestions
Replace the meta-description with concrete actions the skill performs (e.g., 'Generates greeting messages, creates sample output for testing')
Add a 'Use when...' clause with explicit trigger terms that describe when Claude should select this skill
Include natural keywords users would actually say when they need this functionality, rather than developer-focused terminology
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language ('simple hello world skill') without describing any concrete actions or capabilities. It focuses on meta-purpose (testing workflows) rather than what the skill actually does. | 1 / 3 |
Completeness | Fails to answer both 'what does this do' (no functional capabilities described) and 'when should Claude use it' (no 'Use when...' clause or trigger guidance). Only describes its meta-purpose. | 1 / 3 |
Trigger Term Quality | Contains no natural keywords a user would say when needing this skill. 'Testing publish workflows' is internal/developer jargon, not user-facing trigger terms. | 1 / 3 |
Distinctiveness Conflict Risk | Extremely generic - 'hello world' and 'testing' could apply to countless skills. Provides no distinct niche or specific triggers to differentiate it from other skills. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
20%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill content is mostly meta-description about the publishing workflow rather than actionable instructions for Claude. The actual task (greeting the user) is simple but buried in verbose explanation about CI/CD pipelines and the Tessl ecosystem that Claude doesn't need. The content would be far more effective as a single sentence instruction with an example output.
Suggestions
Remove all meta-description about publishing workflows, GitHub Actions, and the Tessl ecosystem - this is not relevant to executing the skill
Reduce to a single clear instruction like: 'Greet the user with a friendly hello world message introducing them to tiles and skills.'
Add a concrete example of the expected greeting output so Claude knows the tone and content expected
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is extremely verbose for what it does. It explains what the skill is for (testing publish workflows, CI/CD pipelines, GitHub Actions) rather than instructing Claude on what to do. Most of this is meta-explanation Claude doesn't need. | 1 / 3 |
Actionability | The only actionable instruction is 'greet the user with a friendly hello world message' - the rest is abstract description about publishing workflows and the Tessl ecosystem with no concrete examples or specific guidance on what the greeting should contain. | 1 / 3 |
Workflow Clarity | For a simple single-action skill, the core task (greet user) is identifiable, but it's buried in unnecessary context. No validation or examples of expected output are provided. | 2 / 3 |
Progressive Disclosure | The content is a single block of text with no structure or organization. For a simple skill this could be acceptable, but the lack of any formatting (headers, examples) makes it harder to parse the actual instruction from the meta-description. | 2 / 3 |
Total | 6 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Install with Tessl CLI
npx tessl i bapfernandez/test-publish@0.8.0Reviewed
Table of Contents