CtrlK
BlogDocsLog inGet started
Tessl Logo

markdown-documents

Write or edit Markdown notes, reports and plain text; default for non-Office writing.

62

Quality

78%

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 ./plugins/_office/skills/markdown-documents/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 tight, actionable instruction-only skill: a clear workflow, an executable create example, and valuable agent-specific policy about the user-owned Editor surface. Its only weakness is slight redundancy between the intro and the practical-rules list, plus a missing edit/patch example.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (no explanation of what Markdown is), with only a minor redundancy: the prefer-Markdown-over-ODT/DOCX guidance appears both in the opening paragraph and again as the first Practical rules bullet, which could be trimmed; this fits anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

An executable JSON text_editor example with an explicit .md path, concrete patch-vs-write edit guidance, and the specific open_in_canvas flag make the guidance mostly copy-paste ready; the minor gap is that the edit/patch path has no example, keeping it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The four-step workflow (decide whether an artifact is useful, create with an explicit .md path, read-then-patch-or-write for edits, report the path) is clearly sequenced and unambiguous. Operations are neither destructive nor batch, so the validation cap does not apply, and the simple-skill exception allows a 5 for a single clearly-guided task.

5 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections (overview, workflow, example, practical rules) and no content that warrants external reference files; the simple-skill exception applies, so well-organized sections alone merit a 5.

5 / 5

Total

18

/

20

Passed

Description

62%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.

The description cleanly states what the skill does and positions it as the default for non-Office writing, giving it decent distinctiveness. However, action coverage is thin (only write/edit), and it lacks a 'Use when...' trigger clause with the natural terms and file extensions (.md, draft, brief) users would actually say.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user asks for notes, reports, briefs, drafts, or any writing not destined for an Office/binary format.'

Include natural trigger keywords and the file extension in the description itself (e.g. 'Markdown (.md)', 'draft', 'brief') rather than only in the frontmatter triggers list.

Broaden action coverage beyond write/edit to the other concrete capabilities the body mentions (e.g. patching targeted edits, creating tables and structured headings).

DimensionReasoningScore

Specificity

"Write or edit Markdown notes, reports and plain text" names the domain plus exactly two concrete actions (write, edit), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; it does not list the several specific actions needed for a 4.

3 / 5

Completeness

A clear 'what' ("Write or edit Markdown notes, reports and plain text") and an explicit 'when' ("default for non-Office writing") are both present, but the 'when' is phrased as a default rather than a 'Use when...' trigger clause and could be more specific; this fits anchor 4, not 3 (the 'when' is stated, not merely implied) and not 5 (no concrete user-trigger phrasing).

4 / 5

Trigger Term Quality

Natural keywords like "Markdown", "notes", "reports", and "plain text" are present, but common variations and synonyms users would say (".md", "md", "draft", "brief") are missing from the description, matching the 'some relevant keywords but missing common variations' anchor.

3 / 5

Distinctiveness Conflict Risk

The "default for non-Office writing" clause explicitly carves out a niche distinct from Office-format skills, but "notes, reports and plain text" is broad writing territory with minor overlap risk against other writing/document skills, matching anchor 4.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
agent0ai/agent-zero
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.