Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Professional Markdown Documentation · aiskillstore | DecimalAI

documentationby aiskillstore

Professional Markdown Documentation

aiskillstore/markdown-pro

Source aiskillstore/marketplace ↗License Not recorded

Professional Markdown documentation skill for creating polished README files, changelogs, contribution guides, and technical documentation.

SkillScore84Maintained

Automatic

Doc Ops pack

Last verified 9/2/2026

What it changes

Passed 21 of 25 test cases with the skill, and 16 of 25 without it.

Without skill64%

With skill84%

Checks it passed that the model alone missed

Formats potential exceptions under a bold **Raises:** header.
Formats expected return values under a bold **Returns:** header.
Recommends running python scripts/markdown_helper.py toc README.md.

and 3 more in the full report

5 fixed16 passed either way4 still failing0 broke

Pass-rate lift: +20 pp
Tokens: +157%
Agent turns: 0%
Response time: -5%

Model gemini-3.6-flashMeasured 9/2/2026v121 of 25 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/aiskillstore-markdown-pro/SKILL.md https://app.decimal.ai/s/aiskillstore-markdown-pro/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add aiskillstore-markdown-pro, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/aiskillstore-markdown-pro/ and pins it in .decimal/skills.lock

decimalai skills add aiskillstore-markdown-pro

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/aiskillstore-markdown-pro/SKILL.md https://app.decimal.ai/s/aiskillstore-markdown-pro/SKILL.md

Raw file: /s/aiskillstore-markdown-pro/SKILL.md ↗ · machine-readable summary at /s/aiskillstore-markdown-pro.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 5 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 5

Prompt

Create the top header section for an open-source project named DataVault, featuring a single H1 title, license and build badges immediately below the title, and a one-line summary sentence.

What was checked, without and with the skill
Checked	Without skill	With skill
Contains only one H1 heading (# DataVault) for the main project title.	Missed	Passed
Places badge image markup directly beneath the H1 title before the project description.	Passed	Passed

case-13 · gemini-3.6-flash · 9/2/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md448 lines2 filesincludes scripts

Professional Markdown Documentation

Overview

This skill provides comprehensive guidance for creating professional, well-structured Markdown documentation. It covers README files, changelogs, contribution guides, and technical documentation with modern formatting, badges, and best practices.

Core Capabilities

README Generation

Project overview and description
Installation instructions
Usage examples with code blocks
API documentation
Badges and shields
Feature highlights
Screenshots and demos

Changelog Automation

Semantic versioning format
Git history parsing
Automated release notes
Breaking changes highlighting
Contributor attribution

Technical Documentation

Clear section hierarchy
Code syntax highlighting
API reference formatting
Table of contents
Cross-referencing
Collapsible sections

README Structure Best Practices

Essential Sections

1. Header with Badges

# Project Name

Track record

Benchmark

21 / 25

test cases passed, vs 16 / 25 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/10/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

aiskillstore / marketplace

skills/autumnsgrove/markdown-pro/SKILL.md

View on GitHub ↗

Imported 8/10/2026Version v1Bundled 1 file · scripts

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Professional Markdown Documentation

Overview

Core Capabilities

README Generation

Changelog Automation

Technical Documentation

README Structure Best Practices

Essential Sections

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills