Formatting conventions for markdown files — line width, table alignment, diagrams, and style.

Apache-2.0Auto-check passedDocuments & Office

Install Writing Markdown

skills CLI
$ npx skills add asymmetric-research/solana-exporter --skill writing-markdown -a claude-code

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

GitHub CLI
$ gh skill install asymmetric-research/solana-exporter writing-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/asymmetric-research/solana-exporter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/writing-markdown .claude/skills/writing-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
writing-markdown
GitHub stars
133
Token cost
~576 tokens
SKILL.md length
223 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Formatting conventions for markdown files — line width, table alignment, diagrams, and style.

  • Editing any .md file
  • SKILL.md covers Line Width, Tables, Diagrams and General Style
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Diagrams

What it does

Writing Markdown is an agent skill from asymmetric-research/solana-exporter. Formatting conventions for markdown files — line width, table alignment, diagrams, and style. Use when creating or editing any .md file.

Its SKILL.md is about 580 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 Diagrams and Markdown. The repository describes itself as: Prometheus monitor for the Solana blockchain. The licence is Apache-2.0.

When your agent uses it

  • Editing any .md file
  • Tasks that involve Diagrams
  • Tasks that involve Markdown

Example prompts

  • “/writing-markdown”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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

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

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

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 asymmetric-research/solana-exporter at commit 4b7d4ab, republished under its Apache-2.0 licence (© asymmetric-research). 223 words, ~576 tokens.

Download SKILL.mdSave it as .claude/skills/writing-markdown/SKILL.md (or your agent's skills folder).
name
writing-markdown
description
Formatting conventions for markdown files — line width, table alignment, diagrams, and style. Use when creating or editing any .md file.

Writing Markdown

Conventions for all markdown files in this project.

Line Width

Hard-wrap prose at 120 characters. This applies to paragraphs, list items, and block quotes. Do not wrap:

  • URLs (keep on one line even if they exceed 120 chars)
  • Code blocks (respect the natural line length of the code)
  • Table rows (align columns instead — see below)
  • Headings (keep on one line)

Tables

Pad every cell so that columns are visually aligned in the raw source. Use dashes and colons in the separator row to match the widest cell in each column.

Good:

markdown
| Name       | Type   | Description                |
|------------|--------|----------------------------|
| id         | UUID   | Primary key.               |
| created_at | TIME   | Row creation timestamp.    |
| status     | STRING | One of: active, archived.  |

Bad:

markdown
| Name | Type | Description |
|---|---|---|
| id | UUID | Primary key. |
| created_at | TIME | Row creation timestamp. |
| status | STRING | One of: active, archived. |

Rules:

  • One space of padding on each side of every cell.
  • Separator dashes fill the full column width.
  • Right-align numeric columns with : in the separator (e.g. ------:).

Diagrams

Use Mermaid for flowcharts, sequence diagrams, state machines, and similar visuals. Wrap in a fenced code block with the mermaid language tag:

markdown
```mermaid
graph LR
    A[Client] --> B[UI API]
    B --> C[Storage]
    B --> D[Orchestrator]
```

Prefer graph LR (left-to-right) for pipelines and graph TD (top-down) for hierarchies. Use sequenceDiagram for request/response flows.

General Style

  • Use ATX headings (#, ##, ###). No setext (underline) headings.
  • One blank line before and after headings, code blocks, and tables.
  • Use fenced code blocks with a language tag (```go, ```sql, ```bash). Never use indented code blocks.
  • Prefer - for unordered lists.
  • Use **bold** for emphasis, not __underscores__.
  • No trailing whitespace on any line.
  • End files with a single newline.
  • No emojis unless explicitly requested.

© asymmetric-research, Apache-2.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 .agents/skills/writing-markdown of asymmetric-research/solana-exporter.

Open the folder on GitHubat commit 4b7d4ab

Compare with similar skills

Writing 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.

Writing Markdown compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Markdown this skillasymmetric-research/solana-exporter133—~576Automated safety check: PassApache-2.0
Markvisgeekplux/markvis1.6k—~786Automated safety check: PassMIT
Smalldocs Authorespressoplease/smalldocs209—~1.1kAutomated safety check: PassCustom licence
Markdown Syntax Guideantdigital-ai/agentic-ui224—~3.1kAutomated safety check: PassMIT
Markdown Report WritingNeuroAIHub/BrainPilot1.1k—~2.6kAutomated safety check: WarnAGPL-3.0
Axiom Explainerdigoal/blog8.6k—~3.6kAutomated safety check: PassGPL-2.0

Similar skills

  • Markvis

    geekplux/markvis

    A skill your agent uses when the user wants a chart of numbers in Markdown (bar, line, area, scatter, pie, hist, heatmap, funnel, waterfall, radar, gauge, sankey, treemap, dumbbell, bullet, boxplot…

    1.6k GitHub stars~786 tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Smalldocs Author

    espressoplease/smalldocs

    Create finished SmallDocs Markdown for an application using the SmallDocs renderer.

    209 GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Markdown Syntax Guide

    antdigital-ai/agentic-ui

    指导用户使用 @ant-design/agentic-ui 的 Markdown Editor / Renderer 扩展语法。图表场景优先使用内置 chart(HTML 注释 chartType + 表格),只有当内置 chartType 都不能表达诉求时才回退 Mermaid。Triggers on keywords like 表格, 视频, 图表, 卡片, 提示块, 流程图, 语法…

    224 GitHub stars~3.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Markdown Report Writing

    NeuroAIHub/BrainPilot

    Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian.

    1.1k GitHub stars~2.6k tokensUpdated 8 days ago
    Documents & OfficeAuto-check: warnings
  • Axiom Explainer

    digoal/blog

    Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with…

    8.6k GitHub stars~3.6k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Docs Diagrams

    vercel/next.js

    Official

    Draw diagrams for the Next.js docs in the style of the ones already published there: the light/dark PNGs an mdx references with <Image srcLight="/docs/light/<name.png" srcDark="/docs/dark/<name.png".

    143k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from asymmetric-research/solana-exporter

  • Go Standards

    asymmetric-research/solana-exporter

    Idiomatic Go conventions — naming, error handling, concurrency, interfaces, testing, and API design.

    133 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Writing Markdown

What does Writing Markdown do?

Formatting conventions for markdown files — line width, table alignment, diagrams, and style. Writing Markdown is an agent skill from asymmetric-research/solana-exporter. Formatting conventions for markdown files — line width, table alignment, diagrams, and style.

When should I use Writing Markdown?

Writing Markdown fits situations like: editing any .md file; tasks that involve Diagrams; tasks that involve Markdown.

How do I install Writing Markdown in Claude Code?

Run `npx skills add asymmetric-research/solana-exporter --skill writing-markdown -a claude-code`. Or copy the skill folder (.agents/skills/writing-markdown in asymmetric-research/solana-exporter) into .claude/skills/writing-markdown in your project. Claude Code loads it when a task matches its description.

How do I install Writing Markdown in Codex?

Run `npx skills add asymmetric-research/solana-exporter --skill writing-markdown -a codex`. Or copy the skill folder (.agents/skills/writing-markdown in asymmetric-research/solana-exporter) into .agents/skills/writing-markdown in your project. Codex loads it when a task matches its description.

Can I use Writing 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 asymmetric-research/solana-exporter --skill writing-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/writing-markdown, .gemini/skills/writing-markdown, .github/skills/writing-markdown and .opencode/skills/writing-markdown in your project.

What does Writing Markdown need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Markdown is instructions for the agent only.

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

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

How many tokens does Writing Markdown use?

About 576 tokens (SKILL.md is roughly 2.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 Writing Markdown?

Skills that share tags, products or a category with Writing Markdown: Markvis (geekplux/markvis, 1.6k stars), Smalldocs Author (espressoplease/smalldocs, 209 stars), Markdown Syntax Guide (antdigital-ai/agentic-ui, 224 stars) and Markdown Report Writing (NeuroAIHub/BrainPilot, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Markdown?

asymmetric-research (a GitHub organization) maintains it in asymmetric-research/solana-exporter, which has 133 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 31, 2026.

Source: asymmetric-research/solana-exporter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.