CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/markdown-authoring

Author high-quality Markdown documentation with deterministic structure, lint compliance, and CI integration. Use when writing README files, creating docs pages, fixing markdownlint failures, defining style rules, or wiring markdown checks into pre-commit and pipelines. Keywords: markdown, markdownlint, readme, docs, headings, lists, code fences, links, images, lint config, ci, documentation style.

Overall
score

100%

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

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 key criteria. It provides specific concrete actions, includes a comprehensive 'Use when...' clause with clear triggers, and adds an explicit Keywords section for discoverability. The description is well-structured, uses third person voice correctly, and carves out a distinct niche around Markdown documentation with linting and CI focus.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Author high-quality Markdown documentation', 'deterministic structure', 'lint compliance', 'CI integration', 'writing README files', 'creating docs pages', 'fixing markdownlint failures', 'defining style rules', 'wiring markdown checks into pre-commit and pipelines'.

3 / 3

Completeness

Clearly answers both what ('Author high-quality Markdown documentation with deterministic structure, lint compliance, and CI integration') AND when ('Use when writing README files, creating docs pages, fixing markdownlint failures, defining style rules, or wiring markdown checks into pre-commit and pipelines').

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say, including explicit Keywords section with: 'markdown', 'markdownlint', 'readme', 'docs', 'headings', 'lists', 'code fences', 'links', 'images', 'lint config', 'ci', 'documentation style'. These match how users naturally describe documentation tasks.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused specifically on Markdown documentation with lint compliance and CI integration. The specific mentions of 'markdownlint', 'pre-commit', and 'pipelines' distinguish it from generic documentation or writing skills.

3 / 3

Total

12

/

12

Passed

Implementation

100%

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 with excellent structure, actionable commands, and clear validation workflows. The content respects token efficiency while providing comprehensive coverage through well-organized references. The anti-patterns section adds practical value with concrete BAD/GOOD examples.

DimensionReasoningScore

Conciseness

The content is lean and efficient, avoiding explanations of what Markdown is or how linting works. Every section serves a purpose with no padding or unnecessary context.

3 / 3

Actionability

Provides fully executable bash commands with expected results, concrete anti-patterns with BAD/GOOD examples, and a clear deterministic workflow. Commands are copy-paste ready.

3 / 3

Workflow Clarity

The 5-step deterministic workflow includes explicit validation checkpoints with a lint-fix feedback loop clearly articulated. The instruction 'Do not proceed until lint is clean' establishes a clear gate.

3 / 3

Progressive Disclosure

Excellent structure with a concise overview and 16 well-organized one-level-deep references covering syntax, docs, and lint topics. Navigation is clear and content is appropriately split.

3 / 3

Total

12

/

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.

Install with Tessl CLI

npx tessl i pantheon-ai/markdown-authoring

Reviewed

Table of Contents