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.

95

1.00x
Quality

92%

Does it follow best practices?

Impact

97%

1.00x

Average score across 7 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

92%Weight 40%Scale 1-3

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

A well-organized, concise, actionable skill body with strong workflow validation. Its main weakness is progressive disclosure: the References and Quick Commands point to bundle files and scripts that are absent, leaving navigation dead-ends.

Suggestions

Ship the referenced bundle: create the 16 references/*.md files and ./scripts/read-reference.sh so the body's navigation resolves.

Verify the path in `sh skills/agentic-harness/skill-quality-auditor/scripts/evaluate.sh ...` actually exists, or replace it with a working invocation.

If some references are not yet available, mark them as planned/stub so the disclosure structure is honest about what exists.

DimensionReasoningScore

Conciseness

Lean body with no elementary explanations of what Markdown is; principles and commands are terse and every section earns its tokens, matching the lean-and-efficient score-3 anchor.

3 / 3

Actionability

Quick Commands provides fully executable, copy-paste-ready commands (e.g. `bunx markdownlint-cli2 "**/*.md"`, `bun run check-style`, `./scripts/read-reference.sh syntax-headings`) with expected results, matching the executable-code score-3 anchor.

3 / 3

Workflow Clarity

The Deterministic Workflow gives a clear 5-step sequence with an explicit lint-fix loop and "Do not proceed until lint is clean" validation checkpoint, matching the clear-sequence-with-validation score-3 anchor.

3 / 3

Progressive Disclosure

The body is structured as an overview with a well-signaled one-level-deep References section, but the referenced bundle (16 references/*.md links, ./scripts/read-reference.sh) does not exist on disk, so the disclosure structure is broken rather than usable.

2 / 3

Total

11

/

12

Passed

Description

92%Weight 40%Scale 1-3

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 strong description with concrete actions, an explicit Use-when trigger, and a thorough keyword list. The only weakness is mild overlap risk with general documentation skills, keeping distinctiveness below maximum.

Suggestions

Tighten the niche by leading with markdownlint/lint-compliance framing rather than generic "Markdown documentation" to reduce overlap with general doc skills.

Consider adding a disambiguating clause (e.g. "Not for .rst/.adoc authoring") in the description itself rather than only in the body.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "writing README files, creating docs pages, fixing markdownlint failures, defining style rules, or wiring markdown checks into pre-commit and pipelines" — matching the score-3 anchor of multiple specific concrete actions.

3 / 3

Completeness

Explicitly answers both what ("Author high-quality Markdown documentation with deterministic structure, lint compliance, and CI integration") and when ("Use when writing README files..."), with a clear explicit trigger clause.

3 / 3

Trigger Term Quality

Provides good coverage of natural terms via "Use when writing README files... fixing markdownlint failures" plus an explicit Keywords list (markdown, markdownlint, readme, docs, headings, lists, code fences) that a user would actually say.

3 / 3

Distinctiveness Conflict Risk

The markdownlint/CI niche is fairly distinct, but the broad framing around "documentation" and "docs pages" could overlap with general documentation skills; triggers are specific but not fully unambiguous.

2 / 3

Total

11

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 16 missing

Warning

referenced_paths_exist

Referenced path issues: 16 missing

Warning

Total

14

/

16

Passed

Reviewed

Table of Contents