How do I install the Hackmd skill?

Run npx skillmds@latest add dvcrn/hackmd in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hackmd safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hackmd?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hackmd free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hackmd?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hackmd by dvcrn — Agent Skill

Name: Hackmd
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

HackMD Integration

Requirements

npm install -g @hackmd/hackmd-cli

Quick Reference

Read Notes

# List all personal notes
hackmd-cli notes

# Get note metadata (includes lastChangedAt)
hackmd-cli notes --noteId=<id> --output json

# Get note content (markdown)
hackmd-cli export --noteId=<id>

# List teams
hackmd-cli teams

# List team notes
hackmd-cli team-notes --teamPath=<path>

Write Notes

# Create note
hackmd-cli notes create --content='# Title'

# Create from file
cat file.md | hackmd-cli notes create

# Update note
hackmd-cli notes update --noteId=<id> --content='# Updated'

# Delete note
hackmd-cli notes delete --noteId=<id>

Team Notes

hackmd-cli team-notes create --teamPath=<path> --content='# Team Note'
hackmd-cli team-notes update --teamPath=<path> --noteId=<id> --content='...'
hackmd-cli team-notes delete --teamPath=<path> --noteId=<id>

Change Tracking

Use hackmd-track.js (in scripts/) to detect document changes efficiently.

Track a Note

node scripts/hackmd-track.js add <noteId>

Check for Changes

# Single note - outputs content only if changed
node scripts/hackmd-track.js changes <noteId>

# All tracked notes
node scripts/hackmd-track.js changes --all

# JSON output for parsing
node scripts/hackmd-track.js changes <noteId> --json

Manage Tracking

node scripts/hackmd-track.js list              # Show tracked notes
node scripts/hackmd-track.js remove <noteId>   # Stop tracking
node scripts/hackmd-track.js reset <noteId>    # Reset (next check shows as changed)

How It Works

hackmd-track.js add stores note's lastChangedAt timestamp
hackmd-track.js changes compares current lastChangedAt with stored value
If changed: outputs content and updates stored timestamp
If unchanged: outputs nothing (use --verbose for status)

State stored in ./.hackmd/tracked-notes.json (current working directory)

Note Metadata Fields

When using --output json, notes include:

Field	Description
`lastChangedAt`	Unix timestamp of last modification
`lastChangeUser`	`{name, userPath, photo}` of last editor
`titleUpdatedAt`	When title changed
`tagsUpdatedAt`	When tags changed

Rate Limits

100 calls per 5 minutes
2000 calls/month (10k on Prime plan)

---name: hackmddescription: Work with HackMD documents. Use when reading, creating, updating, or deleting notes on HackMD. Supports change tracking to detect document modifications since last check. Supports personal and team workspaces.---# HackMD Integration## Requirements```bashnpm install -g @hackmd/hackmd-cli```## Quick Reference### Read Notes```bash# List all personal noteshackmd-cli notes# Get note metadata (includes lastChangedAt)hackmd-cli notes --noteId=<id> --output json# Get note content (markdown)hackmd-cli export --noteId=<id># List teamshackmd-cli teams# List team noteshackmd-cli team-notes --teamPath=<path>```### Write Notes```bash# Create notehackmd-cli notes create --content='# Title'# Create from filecat file.md | hackmd-cli notes create# Update notehackmd-cli notes update --noteId=<id> --content='# Updated'# Delete notehackmd-cli notes delete --noteId=<id>```### Team Notes```bashhackmd-cli team-notes create --teamPath=<path> --content='# Team Note'hackmd-cli team-notes update --teamPath=<path> --noteId=<id> --content='...'hackmd-cli team-notes delete --teamPath=<path> --noteId=<id>```## Change TrackingUse `hackmd-track.js` (in `scripts/`) to detect document changes efficiently.### Track a Note```bashnode scripts/hackmd-track.js add <noteId>```### Check for Changes```bash# Single note - outputs content only if changednode scripts/hackmd-track.js changes <noteId># All tracked notesnode scripts/hackmd-track.js changes --all# JSON output for parsingnode scripts/hackmd-track.js changes <noteId> --json```### Manage Tracking```bashnode scripts/hackmd-track.js list # Show tracked notesnode scripts/hackmd-track.js remove <noteId> # Stop trackingnode scripts/hackmd-track.js reset <noteId> # Reset (next check shows as changed)```### How It Works1. `hackmd-track.js add` stores note's `lastChangedAt` timestamp2. `hackmd-track.js changes` compares current `lastChangedAt` with stored value3. If changed: outputs content and updates stored timestamp4. If unchanged: outputs nothing (use `--verbose` for status)State stored in `./.hackmd/tracked-notes.json` (current working directory)## Note Metadata FieldsWhen using `--output json`, notes include:| Field | Description || ---------------- | ---------------------------------------- || `lastChangedAt` | Unix timestamp of last modification || `lastChangeUser` | `{name, userPath, photo}` of last editor || `titleUpdatedAt` | When title changed || `tagsUpdatedAt` | When tags changed |## Rate Limits- 100 calls per 5 minutes- 2000 calls/month (10k on Prime plan)

Frequently asked questions

Hackmd