woocommerce-markdown — Claude Code skill for Markdown
The woocommerce-markdown skill applies WooCommerce’s Markdown conventions when you write or edit documentation, README files, and other Markdown content.
GPL-2.0 1 installs ★ 10,608 updated 2026-10-25
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a claude-codeWhat woocommerce-markdown 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.
What it helps with
- 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 for the agent
- Format this README using the WooCommerce Markdown conventions.
- Check
docs.md: runmarkdownlint --fixand thenmarkdownlintfrom the repository root. - Fix the nested lists and add language labels to code blocks in this Markdown file.
How to install woocommerce-markdown
1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a claude-code2Manually: put the files in place
~/.claude/skills/woocommerce-markdown/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/woocommerce-markdown/
1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a codex2Manually: put the files in place
.agents/skills/woocommerce-markdown/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a cursor2Manually: put the files in place
.cursor/skills/woocommerce-markdown/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install woocommerce/woocommerce .ai/skills/woocommerce-markdown2Manually: put the files in place
.github/skills/woocommerce-markdown/SKILL.md1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a gemini-cli2Platform CLI
gemini skills install https://github.com/woocommerce/woocommerce --path .ai/skills/woocommerce-markdownManually: put the files in place
.devin/skills/woocommerce-markdown/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about woocommerce-markdown
How do I install woocommerce-markdown in Claude Code?
Run npx skills add woocommerce/woocommerce --skill woocommerce-markdown -a claude-code. The skill file is at ~/.claude/skills/woocommerce-markdown/SKILL.md.
What does woocommerce-markdown do?
It guides Markdown authoring and editing in WooCommerce and provides project conventions for checking files with markdownlint.
Where should I run markdownlint?
Run it from the WooCommerce repository root so the .markdownlint.json configuration is loaded.