New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Markdown Format

by promovaweb in promovaweb/setupvibe

Enforce and apply SetupVibe Markdown formatting standards when creating or editing any .md file in the repository.

GPL-3.0Auto-check passedDocuments & Office

Install Markdown Format

skills CLI
$ npx skills add promovaweb/setupvibe --skill markdown-format -a claude-code

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

GitHub CLI
$ gh skill install promovaweb/setupvibe markdown-format --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/promovaweb/setupvibe.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/markdown-format .claude/skills/markdown-format && 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-format
GitHub stars
101
Token cost
~938 tokens
SKILL.md length
469 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
GPL-3.0

At a glance

Enforce and apply SetupVibe Markdown formatting standards when creating or editing any .md file in the repository.

  • Works in 4 steps: Discover all Markdown files → Check each file against MARKDOWN.md rules → Fix all violations → …
  • Tasks that involve Markdown
  • SKILL.md covers Source of Truth, Recursive Verification — Full…, Linting with markdownlint CLI and Invocation, plus 1 more section
  • Calls rg

What it does

Markdown Format is an agent skill from promovaweb/setupvibe. Enforce and apply SetupVibe Markdown formatting standards when creating or editing any .md file in the repository.

Its SKILL.md is about 940 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. The repository describes itself as: O script definitivo de configuração de ambiente de desenvolvimento multiplataforma. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “/markdown-format”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Discover all Markdown files
  2. Check each file against MARKDOWN.md rules
  3. Fix all violations
  4. Confirm

What it can do on your machine

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

    • rg

    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 Format loads about 938 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 469 words of instructions outside code blocks.

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

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 promovaweb/setupvibe at commit e86a16d, republished under its GPL-3.0 licence (© promovaweb). 469 words, ~938 tokens.

Download SKILL.mdSave it as .claude/skills/markdown-format/SKILL.md (or your agent's skills folder).
name
markdown-format
description
Enforce and apply SetupVibe Markdown formatting standards when creating or editing any .md file in the repository.

Markdown Format

Apply the SetupVibe Markdown rules to every .md file you create or edit, and verify all Markdown files in the repository recursively.

Source of Truth

All formatting rules, markdownlint rule IDs, configuration values, and examples are defined in MARKDOWN.md at the project root. Read that file before applying rules. Do not derive rules from AGENTS.md, CLAUDE.md, or any other file — MARKDOWN.md is authoritative.

The markdownlint configuration is in .markdownlint.json.

Recursive Verification — Full Repository Scan

When invoked, this skill must scan all .md files in the repository recursively, not just the files directly modified by the current task.

Step 1 — Discover all Markdown files

Use rg from the repository root to find every .md file in the project:

bash
rg --files -g '*.md'

This includes (but is not limited to):

  • Root context files: CLAUDE.md, AGENTS.md, MARKDOWN.md, CHANGELOG.md, README.md, CONTRIBUTING.md
  • docs/**/*.md — all languages (en/, pt-br/, es/, fr/) and all subdirectories
  • .codex/skills/**/*.md — Codex skill definitions
  • .claude/skills/**/*.md — Claude skill definitions
Step 2 — Check each file against MARKDOWN.md rules

For every file found, verify:

RuleCheck
MD001Heading levels increment by one — never skip levels
MD003ATX heading style (# prefix only)
MD004Unordered lists use - markers only
MD009No trailing spaces on any line
MD010No hard tab characters
MD012At most one consecutive blank line
MD022Exactly one blank line before and after every heading
MD031Exactly one blank line before and after every fenced code block
MD032Exactly one blank line before and after every list
MD033No inline HTML tags
MD034No bare URLs — all links use [text](url) syntax
MD040Every fenced code block specifies a language
MD047File ends with exactly one newline character
MD049Emphasis uses * not _
MD050Strong uses ** not __
Show full SKILL.md (191 more words)Show less
Step 3 — Fix all violations

For each violation found:

  1. Fix it in place using apply_patch for manual edits. Never remove content — format only.
  2. Table pipes: align columns for raw readability.
  3. Code blocks: detect language from context if missing (bash, zsh, js, json, markdown, text).
  4. List markers: convert * and + to -.
  5. Blank lines: add or remove to satisfy MD022, MD031, MD032.
Step 4 — Confirm

After fixing, re-read each modified file and confirm no violations remain before marking the task complete.

Linting with markdownlint CLI

Run the full recursive scan from the project root:

bash
markdownlint "**/*.md" --ignore node_modules --config .markdownlint.json

Check a single file:

bash
markdownlint path/to/file.md --config .markdownlint.json

Invocation

Use this skill whenever a Codex task creates or edits Markdown in this repository. Always run the full recursive scan — do not limit the check to only the files touched in the current task.

Regra Obrigatória — Markdown

Ao criar ou modificar qualquer arquivo .md, você DEVE invocar a skill /markdown-format antes de concluir a tarefa. A skill deve verificar TODOS os arquivos .md do repositório recursivamente, não apenas os arquivos editados. As regras estão em MARKDOWN.md. Esta regra é inegociável e se aplica a qualquer skill, independente do seu escopo.

© promovaweb, GPL-3.0. 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 .codex/skills/markdown-format of promovaweb/setupvibe.

Open the folder on GitHubat commit e86a16d

Compare with similar skills

Markdown Format 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 Format compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Markdown Format this skillpromovaweb/setupvibe101—~938Automated safety check: PassGPL-3.0
Markdown Article FormatterJimLiu/baoyu-skills26k7 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
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Crosspostingwasp-lang/wasp19k—~1.1kAutomated safety check: PassMIT

Similar skills

  • 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 7 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

  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

  • Review The Docs

    supabase/supabase

    Official

    Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).

    111k GitHub stars~4.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from promovaweb/setupvibe

All 8 skills in this repo

  • Bash Defensive Patterns

    promovaweb/setupvibe

    Master defensive Bash programming techniques for production-grade scripts.

    101 GitHub starsUsed in 15 repos~572 tokens
    Auto-check passed

  • Bash Scripting

    promovaweb/setupvibe

    Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

    101 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed

  • Bash Pro

    promovaweb/setupvibe

    Master of defensive Bash scripting for production automation, CI/CD pipelines, and system utilities.

    101 GitHub starsUsed in 11 repos~4.7k tokens
    Auto-check passed

  • Documentation

    promovaweb/setupvibe

    Workflow mestre para gestão de documentação do SetupVibe. An agent skill from promovaweb/setupvibe.

    101 GitHub stars~477 tokensUpdated 1 mo ago
    Auto-check passed

  • Documentation

    promovaweb/setupvibe

    Workflow mestre para gestão de documentação do SetupVibe. An agent skill from promovaweb/setupvibe.

    101 GitHub stars~489 tokensUpdated 1 mo ago
    Auto-check passed

  • Make Changelog

    promovaweb/setupvibe

    Gerencia entradas no CHANGELOG.md seguindo Keep a Changelog.

    101 GitHub stars~470 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Markdown Format

What does Markdown Format do?

Enforce and apply SetupVibe Markdown formatting standards when creating or editing any .md file in the repository. Markdown Format is an agent skill from promovaweb/setupvibe.md file in the repository.

When should I use Markdown Format?

Markdown Format fits situations like: tasks that involve Markdown.

How do I install Markdown Format in Claude Code?

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

How do I install Markdown Format in Codex?

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

Can I use Markdown Format 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 promovaweb/setupvibe --skill markdown-format -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-format, .gemini/skills/markdown-format, .github/skills/markdown-format and .opencode/skills/markdown-format in your project.

What does Markdown Format need to run?

Going by SKILL.md and its folder, Markdown Format needs the command-line tools its instructions call (rg).

Does Markdown Format 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 Format 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 Format use?

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

How many tokens does Markdown Format use?

About 938 tokens (SKILL.md is roughly 3.8k 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 Format?

Skills that share tags, products or a category with Markdown Format: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Markdown Format?

promovaweb (a GitHub organization) maintains it in promovaweb/setupvibe, which has 101 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 21, 2026.

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