# woocommerce-markdown

The woocommerce-markdown skill applies WooCommerce’s Markdown conventions when you write or edit documentation, README files, and other Markdown content.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 10608 repo stars
- Author: woocommerce
- License: GPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-markdown/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/woocommerce-markdown

## What it does

The skill sets project rules for headings, lists, tables, links, and code fences. Nested list items use four-space indentation, and fenced code blocks need a language label. Directory trees use UTF-8 box-drawing characters.

After editing, run `markdownlint --fix`, then `markdownlint`. Run both from the repository root so `.markdownlint.json` is loaded. Auto-fixing does not handle every issue; code blocks may still need language labels added by hand.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/woocommerce-markdown/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/woocommerce-markdown/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/woocommerce-markdown/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/woocommerce-markdown/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install woocommerce/woocommerce .ai/skills/woocommerce-markdown
```

2. **Manually: put the files in place**
- File: `.github/skills/woocommerce-markdown/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/woocommerce/woocommerce --path .ai/skills/woocommerce-markdown
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/woocommerce-markdown/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-markdown/SKILL.md

## When to use it
- format headings and lists to WooCommerce conventions
- lint a Markdown file after editing
- correct common Markdown lint issues
- draw directory trees with UTF-8 characters

## Example prompts
- Format this README using the WooCommerce Markdown conventions.
- Check `docs.md`: run `markdownlint --fix` and then `markdownlint` from the repository root.
- Fix the nested lists and add language labels to code blocks in this Markdown file.

## Similar
- [woocommerce-copy-guidelines](https://affpapa.org/en/nevibecode/skills/woocommerce-copy-guidelines.md) — skill · 381 installs
- [baoyu-markdown-to-html](https://affpapa.org/en/nevibecode/skills/baoyu-markdown-to-html.md) — skill · 32900 installs
- [baoyu-url-to-markdown](https://affpapa.org/en/nevibecode/skills/baoyu-url-to-markdown.md) — skill · 31000 installs
- [convert-documents-to-markdown](https://affpapa.org/en/nevibecode/skills/convert-documents-to-markdown.md) — skill · 13700 installs
- [markdown-to-html](https://affpapa.org/en/nevibecode/skills/markdown-to-html.md) — skill · 9899 installs
- [update-markdown-file-index](https://affpapa.org/en/nevibecode/skills/update-markdown-file-index.md) — skill · 8900 installs

From the same set: [woocommerce/woocommerce](https://affpapa.org/en/nevibecode/by/woocommerce/woocommerce.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
