# Send HackMD to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hackmd",
    "name": "HackMD",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/nulltea/hackmd",
    "canonicalUrl": "https://clawhub.ai/nulltea/hackmd",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/hackmd",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hackmd",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "_meta.json",
      "SKILL.md",
      "scripts/hackmd-track.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "hackmd",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:17:21.690Z",
      "expiresAt": "2026-05-07T03:17:21.690Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hackmd",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hackmd",
        "contentDisposition": "attachment; filename=\"hackmd-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "hackmd"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/hackmd"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/hackmd",
    "downloadUrl": "https://openagent3.xyz/downloads/hackmd",
    "agentUrl": "https://openagent3.xyz/skills/hackmd/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hackmd/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hackmd/agent.md"
  }
}
```
## Documentation

### Requirements

npm install -g @hackmd/hackmd-cli

### 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:

FieldDescriptionlastChangedAtUnix timestamp of last modificationlastChangeUser{name, userPath, photo} of last editortitleUpdatedAtWhen title changedtagsUpdatedAtWhen tags changed

### Rate Limits

100 calls per 5 minutes
2000 calls/month (10k on Prime plan)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: nulltea
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:17:21.690Z
- Expires at: 2026-05-07T03:17:21.690Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/hackmd)
- [Send to Agent page](https://openagent3.xyz/skills/hackmd/agent)
- [JSON manifest](https://openagent3.xyz/skills/hackmd/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/hackmd/agent.md)
- [Download page](https://openagent3.xyz/downloads/hackmd)