Agent skill

Markdown

by JanDeDobbeleer in JanDeDobbeleer/oh-my-posh

Markdown formatting rules for this project. An agent skill from JanDeDobbeleer/oh-my-posh.

MITAuto-check passedDocuments & Office

Install Markdown

skills CLI
$ npx skills add JanDeDobbeleer/oh-my-posh --skill markdown -a claude-code

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

GitHub CLI
$ gh skill install JanDeDobbeleer/oh-my-posh 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/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/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
24k
Token cost
~754 tokens
SKILL.md length
392 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Markdown formatting rules for this project. An agent skill from JanDeDobbeleer/oh-my-posh.

  • Works in 9 steps: Headings: Use appropriate heading levels… → Lists: Use bullet points or numbered… → Code Blocks: Use fenced code blocks for… → …
  • Tasks that involve Markdown
  • SKILL.md covers Formatting and Structure, Post-Edit Verification and Validation Requirements
  • Calls npx

What it does

Markdown is an agent skill from JanDeDobbeleer/oh-my-posh. Markdown formatting rules for this project. Apply when writing or editing any .md or .mdx file, including documentation and website content.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Markdown. It works with Bash. The repository describes itself as: The most customisable and low-latency cross platform/shell prompt renderer. The licence is MIT.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “/markdown”

Requirements

  • Node.js

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Headings: Use appropriate heading levels (H2, H3, etc.) to structure your content.
  2. Lists: Use bullet points or numbered lists for lists. Ensure proper
  3. Code Blocks: Use fenced code blocks for code snippets. Specify the language
  4. Links: Use proper markdown syntax for links. Ensure that links are valid and
  5. Images: Use proper markdown syntax for images. Include alt text for
  6. Tables: Use markdown tables for tabular data. Ensure proper formatting and
  7. Line Length: Limit line length to 120 characters for readability.
  8. Whitespace: Use appropriate whitespace to separate sections and improve readability.
  9. Front Matter: Include YAML front matter at the beginning of the file with required metadata fields.

What it can do on your machine

Read from SKILL.md and the folder at commit 1d6bd96. 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

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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 754 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 392 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from JanDeDobbeleer/oh-my-posh at commit 1d6bd96, republished under its MIT licence (© JanDeDobbeleer). 392 words, ~754 tokens.

Download SKILL.mdSave it as .claude/skills/markdown/SKILL.md (or your agent's skills folder).
name
markdown
description
Markdown formatting rules for this project. Apply when writing or editing any .md or .mdx file, including documentation and website content.

Markdown Content Rules

The following markdown content rules are enforced in the validators:

  1. Headings: Use appropriate heading levels (H2, H3, etc.) to structure your content. Do not use an H1 heading, as this will be generated based on the title.
  2. Lists: Use bullet points or numbered lists for lists. Ensure proper indentation and spacing.
  3. Code Blocks: Use fenced code blocks for code snippets. Specify the language for syntax highlighting.
  4. Links: Use proper markdown syntax for links. Ensure that links are valid and accessible.
  5. Images: Use proper markdown syntax for images. Include alt text for accessibility.
  6. Tables: Use markdown tables for tabular data. Ensure proper formatting and alignment.
  7. Line Length: Limit line length to 120 characters for readability.
  8. Whitespace: Use appropriate whitespace to separate sections and improve readability.
  9. Front Matter: Include YAML front matter at the beginning of the file with required metadata fields.

Formatting and Structure

Follow these guidelines for formatting and structuring your markdown content:

  • Headings: Use ## for H2 and ### for H3. Ensure that headings are used in a hierarchical manner. Recommend restructuring if content includes H4, and more strongly recommend for H5.

  • Lists: Use - for bullet points and 1. for numbered lists. Indent nested lists with two spaces.

  • Code Blocks: Use fenced code blocks with a language for syntax highlighting:

    go
    fmt.Println("hello")
  • Links:

    • Inline: [Docs](https://example.com/docs)
    • Reference-style: [Docs][docs] and add at the end of the page: [docs]: https://example.com/docs
  • Images: Use ![alt text](image URL) for images. Include a brief description of the image in the alt text.

  • Tables: Use | to create tables. Ensure that columns are properly aligned and headers are included.

  • Line Length: Break lines at 120 characters to improve readability. Use soft line breaks for long paragraphs.

  • Whitespace: Use blank lines to separate sections and improve readability. Avoid excessive whitespace.

Show full SKILL.md (93 more words)Show less

Post-Edit Verification

After editing any .md or .mdx file, run the following command and resolve all reported errors before considering the task complete:

shell
npx markdownlint-cli2 <edited-file>

This closes the feedback loop so violations are caught and fixed immediately rather than relying on an external CI run.

Validation Requirements

Ensure compliance with the following validation requirements:

  • Content Rules: Ensure that the content follows the markdown content rules specified above.
  • Formatting: Ensure that the content is properly formatted and structured according to the guidelines.
  • Validation: Run the validation tools to check for compliance with the rules and guidelines.

© JanDeDobbeleer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/markdown of JanDeDobbeleer/oh-my-posh.

Open the folder on GitHubat commit 1d6bd96

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 skillJanDeDobbeleer/oh-my-posh24k—~754Automated safety check: PassMIT
Piclist Uploadcat-xierluo/legal-skills713—~701Automated safety check: PassMIT
Markdown Exporterbowenliang123/markdown-exporter2711 repos~5.3kAutomated safety check: PassApache-2.0
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Piclist Upload

    cat-xierluo/legal-skills

    通过 PicList HTTP Server 将 Markdown 文件中的本地图片上传到图床,并替换为云端链接。本技能应在用户需要上传 Markdown 中的图片、处理包含本地图片引用的 Markdown、批量处理多个 Markdown 文件或目录、或替换本地路径为云端链接以实现跨设备访问时使用。

    713 GitHub stars~701 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Markdown Exporter

    bowenliang123/markdown-exporter

    Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.

    271 GitHub starsUsed in 1 repo~5.3k tokens
    Documents & OfficeAuto-check passed
  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • 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
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed

More from JanDeDobbeleer/oh-my-posh

All 11 skills in this repo
  • Segment Docs

    JanDeDobbeleer/oh-my-posh

    Reference mapping between Oh My Posh Go segment source code and MDX documentation.

    24k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Segment Create

    JanDeDobbeleer/oh-my-posh

    Full scaffolding workflow for creating a new Oh My Posh segment.

    24k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Architecture

    JanDeDobbeleer/oh-my-posh

    Cross-language architecture and clean-code principles for this project: Clean Code, Object Calisthenics, SOLID, guard clauses, hot-path cost, and the code review checklist.

    24k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Conventional Commit

    JanDeDobbeleer/oh-my-posh

    Workflow for generating conventional commit messages following the Conventional Commits specification.

    24k GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Golang

    JanDeDobbeleer/oh-my-posh

    Go coding standards and conventions for this project. An agent skill from JanDeDobbeleer/oh-my-posh.

    24k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Powershell

    JanDeDobbeleer/oh-my-posh

    PowerShell cmdlet conventions for this project. An agent skill from JanDeDobbeleer/oh-my-posh.

    24k GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Works with

Questions about Markdown

What does Markdown do?

Markdown formatting rules for this project. An agent skill from JanDeDobbeleer/oh-my-posh. Markdown is an agent skill from JanDeDobbeleer/oh-my-posh. Markdown formatting rules for this project.

When should I use Markdown?

Markdown fits situations like: tasks that involve Markdown.

How do I install Markdown in Claude Code?

Run `npx skills add JanDeDobbeleer/oh-my-posh --skill markdown -a claude-code`. Or copy the skill folder (.agents/skills/markdown in JanDeDobbeleer/oh-my-posh) 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 JanDeDobbeleer/oh-my-posh --skill markdown -a codex`. Or copy the skill folder (.agents/skills/markdown in JanDeDobbeleer/oh-my-posh) 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 JanDeDobbeleer/oh-my-posh --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 the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Markdown access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. 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. Review the folder before installing.

What licence does Markdown use?

Markdown is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Markdown use?

About 754 tokens (SKILL.md is roughly 3k 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: Piclist Upload (cat-xierluo/legal-skills, 713 stars), Markdown Exporter (bowenliang123/markdown-exporter, 271 stars), Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars) and Markitdown (ImCa0/just-laws, 781 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markdown?

JanDeDobbeleer (a GitHub user) maintains it in JanDeDobbeleer/oh-my-posh, which has 23,555 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 7, 2026.

Source: JanDeDobbeleer/oh-my-posh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.