Agent skill

Markdown

by axoviq-ai in axoviq-ai/synthadoc

“Ingest Markdown and plain text files”

— description from SKILL.md by axoviq-ai
AGPL-3.0-or-laterAuto-check passedDocuments & Office

Install Markdown

skills CLI
$ npx skills add axoviq-ai/synthadoc --skill markdown -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install axoviq-ai/synthadoc markdown --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/axoviq-ai/synthadoc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/synthadoc/skills/markdown .claude/skills/markdown && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
markdown
GitHub stars
1.6k
Token cost
~223 tokens
SKILL.md length
45 words
Files
3 (incl. scripts)
Skills in repo
9
Repo updated
First seen
Licence
AGPL-3.0-or-later

At a glance

  • SKILL.md covers Setup, Standalone usage and When this skill is used
  • Runs Python scripts from its folder

About this skill

Markdown is a skill in axoviq-ai/synthadoc (1.6k stars). Its SKILL.md is about 223 tokens, with 2 other files in the folder (scripts). Licence: AGPL-3.0-or-later.

What it can do on your machine

Read from SKILL.md and the folder at commit 66c9089. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Markdown loads about 223 tokens when it runs. Until then it costs about 11 tokens; SKILL.md has 45 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~11
When it runs · the whole SKILL.md, loaded when a task matches
~223

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from axoviq-ai/synthadoc at commit 66c9089, republished under its AGPL-3.0-or-later licence (© axoviq-ai). 45 words, ~223 tokens.

Download SKILL.mdSave it as .claude/skills/markdown/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
markdown
description
Ingest Markdown and plain text files
version
1.0
entry.script
scripts/main.py
entry.class
MarkdownSkill
triggers.extensions
.md, .txt
triggers.intents
markdown, text file, notes
author
axoviq.com
license
AGPL-3.0-or-later

Markdown Skill

Reads a Markdown or plain text file and returns its content verbatim.

Setup

No external dependencies — uses only the Python standard library.

Standalone usage

python
import asyncio
from synthadoc.skills.markdown.scripts.main import MarkdownSkill

skill = MarkdownSkill()

async def main():
    result = await skill.extract("/path/to/notes.md")
    print(result.text)      # file contents verbatim

asyncio.run(main())

When this skill is used

  • Source path ends with .md or .txt
  • User intent contains: markdown, text file, notes

© axoviq-ai, AGPL-3.0-or-later. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in synthadoc/skills/markdown of axoviq-ai/synthadoc.

  • SKILL.md
  • scripts/__init__.py
  • scripts/main.py

Open the folder on GitHubat commit 66c9089

Compare with similar skills

Markdown next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Markdown compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Markdown this skillaxoviq-ai/synthadoc1.6k—~223Automated safety check: PassAGPL-3.0-or-later
Obsidian MarkdownKevRojo/Dulus167—~1.4kAutomated safety check: PassGPL-3.0
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Pandoc DOCX TemplateAchuan-2/pandoc_docx_template1.1k—~1kAutomated safety check: PassNone
MineruNebutra/MinerU-Skill123—~504Automated safety check: PassMIT

Similar skills

  • Obsidian Markdown

    KevRojo/Dulus

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    167 GitHub stars~1.4k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed
  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Pandoc DOCX Template

    Achuan-2/pandoc_docx_template

    A skill your agent uses when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading…

    1.1k GitHub stars~1k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~504 tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed
  • Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.

    259 GitHub stars~1.5k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

More from axoviq-ai/synthadoc

All 9 skills in this repo
  • Image

    axoviq-ai/synthadoc

    Extract text from images using a vision LLM. An agent skill from axoviq-ai/synthadoc.

    1.6k GitHub stars~544 tokensUpdated yesterday
    Auto-check passed
  • Session

    axoviq-ai/synthadoc

    Extract conversation turns from AI session history files (.jsonl)

    1.6k GitHub stars~902 tokensUpdated yesterday
    Auto-check passed
  • Youtube

    axoviq-ai/synthadoc

    Extract transcripts from YouTube videos via the YouTube caption system

    1.6k GitHub stars~634 tokensUpdated yesterday
    Auto-check passed
  • PPTX

    axoviq-ai/synthadoc

    Extract text from Microsoft PowerPoint presentations. An agent skill from axoviq-ai/synthadoc.

    1.6k GitHub stars~248 tokensUpdated yesterday
    Auto-check passed
  • DOCX

    axoviq-ai/synthadoc

    Extract text from Microsoft Word documents. An agent skill from axoviq-ai/synthadoc.

    1.6k GitHub stars~207 tokensUpdated yesterday
    Auto-check passed
  • PDF

    axoviq-ai/synthadoc

    Extract text from PDF documents

    1.6k GitHub stars~293 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Markdown

How do I install Markdown in Claude Code?

Run `npx skills add axoviq-ai/synthadoc --skill markdown -a claude-code`. Or copy the skill folder (synthadoc/skills/markdown in axoviq-ai/synthadoc) into .claude/skills/markdown in your project. Claude Code loads it when a task matches its description.

How do I install Markdown in Codex?

Run `npx skills add axoviq-ai/synthadoc --skill markdown -a codex`. Or copy the skill folder (synthadoc/skills/markdown in axoviq-ai/synthadoc) into .agents/skills/markdown in your project. Codex loads it when a task matches its description.

Can I use Markdown in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add axoviq-ai/synthadoc --skill markdown -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/markdown, .gemini/skills/markdown, .github/skills/markdown and .opencode/skills/markdown in your project.

What does Markdown need to run?

Going by SKILL.md and its folder, Markdown needs Python for the scripts in its folder.

Does Markdown access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Markdown safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Markdown use?

Markdown is published under the AGPL-3.0-or-later licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Markdown use?

About 223 tokens (SKILL.md is roughly 892 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Markdown?

Skills that share tags, products or a category with Markdown: Obsidian Markdown (KevRojo/Dulus, 167 stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Pandoc DOCX Template (Achuan-2/pandoc_docx_template, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markdown?

axoviq-ai (a GitHub organization) maintains it in axoviq-ai/synthadoc, which has 1,576 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 10, 2026.

Source: axoviq-ai/synthadoc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.