markdown-documents

Use when creating or editing Markdown documents, notes, reports, briefs, drafts, or other editable writing where Markdown should be the primary artifact format.

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%

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

A tight, well-structured single-purpose skill body: it leads with novel platform-specific guidance Claude would not know, gives an executable create example, and sequences a clear decision-gated workflow without padding. No external references are needed given the skill's scope.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence, conveying only platform-specific rules (Editor-surface behavior, ODF vs OOXML preference) and a tight workflow without explaining basic Markdown concepts; every token earns its place.	3 / 3
Actionability	It provides a copy-paste-ready minimal-create JSON example with explicit action, tool, and .md path, and the workflow specifies concrete tool args ('write', 'patch') matching the score-3 anchor for fully executable guidance.	3 / 3
Workflow Clarity	The 4-step workflow is clearly sequenced with an explicit decision gate in step 1; the per scoring notes for a simple single-purpose skill this is unambiguous, and write/patch operations are neither destructive nor batch so no validation loop is required.	3 / 3
Progressive Disclosure	This is a simple under-50-line single-file skill with no external references, and per the scoring notes well-organized sections (purpose, Editor rules, Workflow, practical rules) are sufficient for a score of 3.	3 / 3
	Total	12 / 12 Passed

Description

90%

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 concise, third-person description with an explicit 'Use when' trigger and broad natural keyword coverage. Its only weakness is a somewhat limited action vocabulary (only 'creating or editing'), which keeps specificity at 2 rather than 3.

Suggestions

Expand the action verbs beyond 'creating or editing' to concrete operations like 'formatting, structuring with headings/tables, or converting' to raise specificity.

Consider naming the .md extension explicitly as a trigger term to match common user phrasing.

Dimension	Reasoning	Score
Specificity	Names the Markdown-writing domain and several concrete artifact types (notes, reports, briefs, drafts) plus the actions 'creating or editing', but the action vocabulary is narrow compared to the score-3 anchor that lists multiple distinct operations.	2 / 3
Completeness	It explicitly answers both what (creating/editing Markdown as the primary artifact format) and when via the explicit 'Use when...' clause, satisfying the score-3 anchor.	3 / 3
Trigger Term Quality	The phrase 'Markdown documents, notes, reports, briefs, drafts, or other editable writing' gives good coverage of natural terms users would say, matching the score-3 anchor for natural keyword coverage.	3 / 3
Distinctiveness Conflict Risk	The scoping clause 'where Markdown should be the primary artifact format' carves a clear niche distinct from binary office-file skills, with distinct triggers unlikely to fire for the wrong skill.	3 / 3
	Total	11 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: agent0ai/agent-zero
Path: plugins/_office/skills/markdown-documents/SKILL.md
Commit: 391fab9

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.