CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

marketplace-publishing

Workflow for publishing skills and agents to the dotnet-skills Claude Code marketplace. Covers adding new content, updating plugin.json, validation, and release tagging.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/marketplace-publishing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

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

A well-structured, highly actionable workflow document: concrete commands and templates, explicit validation checkpoints in every workflow, a pre-commit checklist, and troubleshooting for error recovery. The only notable flaws are the invalid JSON comments in the plugin.json examples and a small amount of explanation (semver) that could be trimmed.

DimensionReasoningScore

Conciseness

The body is efficient — concrete commands, JSON snippets, and templates with little padding — but includes minor over-explanation of concepts Claude already knows, notably the semantic versioning explainer ('Use semantic versioning (MAJOR.MINOR.PATCH): MAJOR: Breaking changes...'), so it fits anchor 4 rather than the lean anchor 5.

4 / 5

Actionability

Guidance is mostly executable and copy-paste ready ('./scripts/validate-marketplace.sh', 'git add ... && git commit', '/plugin marketplace add Aaronontheweb/dotnet-skills'), but the plugin.json snippets embed '// Add new skill here' comments, which are invalid JSON and would fail the skill's own 'jq' validation guidance — a minor gap that keeps it below anchor 5.

4 / 5

Workflow Clarity

Both the add-skill workflow (Steps 1-6 with 'Step 5: Validate') and the release process (5 steps with validation as step 2 plus automatic GitHub Actions validation) have explicit validation checkpoints, a pre-commit 'Validation Checklist', and a Troubleshooting section with error-recovery guidance ('Ensure JSON is valid: jq . .claude-plugin/plugin.json'), matching anchor 5's explicit validation, checklists, and recovery guidance.

5 / 5

Progressive Disclosure

The bundle contains no separate files (no references/, scripts/, or assets/ directories) and the single SKILL.md is well organized with clear sections (Repository Structure, Adding a New Skill, Adding a New Agent, Publishing a Release, Troubleshooting) and no nested references. It exceeds the simple under-50-lines case and inlines templates that could live in separate files, so anchor 4 (good structure, minor organization gaps) is the best fit.

4 / 5

Total

17

/

20

Passed

Description

70%Weight 40%Scale 1-5

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

A distinct, domain-specific description that clearly states what the skill covers, but it lacks any explicit 'when to use' trigger guidance, which caps completeness and weakens trigger-term quality. Adding a 'Use when...' clause with natural trigger phrases would raise it to the quality of the good examples.

Suggestions

Add an explicit trigger clause, e.g. 'Use when adding or updating skills or agents in the dotnet-skills repo, registering them in plugin.json, or cutting a marketplace release.'

Replace the generic 'adding new content' with concrete actions such as 'creating SKILL.md folders and agent definition files'.

Include natural trigger synonyms users would actually say, such as 'publish', 'release', 'tag a version', and 'plugin registry', to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('publishing skills and agents to the dotnet-skills Claude Code marketplace') and lists several concrete actions ('updating plugin.json, validation, and release tagging'), but 'adding new content' is generic, leaving minor gaps in coverage that keep it below the comprehensive anchor 5.

4 / 5

Completeness

The 'what' is clear (a publishing workflow covering adding content, plugin.json updates, validation, release tagging), but there is no 'Use when...' clause or equivalent explicit trigger guidance; per the judging guidelines this caps completeness at 3.

3 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say ('publishing', 'skills', 'agents', 'marketplace', 'release tagging'), but a few natural phrases are missing, such as 'new skill', 'add an agent', or 'bump version', so it falls short of the comprehensive-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description names a specific niche ('dotnet-skills Claude Code marketplace') with distinct triggers (plugin.json, release tagging), giving it minimal overlap risk with other skills, matching the clear-niche anchor 5.

5 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Aaronontheweb/dotnet-skills

Path

skills/marketplace-publishing/SKILL.md

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.