hackmd-note
Skill2 starsChanged 4 months agoMITView on GitHub
Write rich, well-formatted HackMD notes using the full range of HackMD-flavored Markdown syntax. Use this skill when the user asks to create, write, or draft a HackMD note, or when the output target is HackMD. Triggers on mentions of "HackMD", "hackmd note", "hackmd 筆記", or requests for notes with HackMD-specific features (:::info admonition blocks, :::spoiler, {%youtube%}/{%pdf%} embeds, slide decks, book mode). Scope: drafts note *content* only — it does not publish to hackmd.io, call any HackMD API/MCP tool, or manage existing notes.
In this repository11 other files it gives its agents.
- codelab-handoutSkill
- course-handoutSkill
- humanizer-zh-twSkill
- interpreting-stock-moodSkill
- learn-notesSkill
- music-disc-videoSkill
- paper-language-passSkill
- survey-designSkill
- teaching-handbookSkill
- tw-namingSkill
- video-researchSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Write information-rich HackMD notes that make full use of HackMD's extended Markdown syntax.
- Distinctive: line 12
Read references/syntax-core.md for the core HackMD syntax.
- Very specific: line 13
Read references/syntax-advanced.md ONLY when the note needs diagrams (mermaid/graphviz/sequence/flow/markmap/vega), music notation, a slide …
- Very specific: line 29
Structure clearly: Use headings (##–####), horizontal rules (---), and tags (
###### tags: tag). - Very specific: line 33
Respect the output mode: If the user asks for a slide deck, use --- / ---- separators and slideOptions YAML.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
HackMD Note Writer
Write information-rich HackMD notes that make full use of HackMD's extended Markdown syntax.
Before Writing
Read references/syntax-core.md for the core HackMD syntax. Read references/syntax-advanced.md ONLY when the note needs diagrams (mermaid/graphviz/sequence/flow/markmap/vega), music notation, a slide deck, or book mode.
Writing Guidelines
- Use the right feature for the job. Pick syntax that enhances readability:
:::info/:::warning/:::danger/:::successfor callouts:::spoilerfor supplementary details the reader can expand> [!TIP]/> [!NOTE]/> [!IMPORTANT]for inline alerts==highlight==for key terms,++underline++for emphasis- Tables for structured comparisons
[TOC]when the note has 4+ sections- Mermaid / flow / sequence / graphviz diagrams when visualizing processes or relationships
- MathJax when formulas appear
{%youtube ID %}/{%pdf URL %}/{%figma URL %}for embeds
- Structure clearly. Use headings (
##–####), horizontal rules (---), and tags (###### tags: `tag`). Lead with a brief summary or context block. - Keep it scannable. Combine prose paragraphs with bullet lists, tables, and diagrams. Avoid walls of text.
- Respect the output mode. If the user asks for a slide deck, use
---/----separators andslideOptionsYAML. If they ask for a book, use===/---with list-of-links structure. - Language. Match the user's language. Default to Traditional Chinese (繁體中文) if the user writes in Chinese.
- Output format. Produce the note as one copy-pasteable block. Because the note itself
usually contains ``` fences (mermaid, code samples), wrap it in a four-backtick fence
(
markdown ...), never a three-backtick one.
範圍邊界
本 skill 只負責產出筆記內容(Markdown 文字),保持無副作用。以下不在範圍:
- 發表/上傳:不呼叫 HackMD API 或
mcp__hackmd__*工具。若使用者要求「發表」且環境有發表用 skill 或 MCP 工具,先用本 skill 完成草稿,再交給該工具/工作流。 - 既有筆記管理:不列出、更新、刪除使用者的 HackMD 筆記。
未來維護者:不要把 API 發表流程加進本 skill——發表涉及帳號、team 路徑、權限等狀態,屬另一條工作流。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

