hackmd

What This Skill Does

The hackmd skill allows OpenClaw agents to interface directly with the HackMD collaborative markdown platform. It provides a full suite of tools to manage personal and team-based documentation, including reading, creating, updating, and deleting notes. Beyond standard CRUD operations, the skill features a specialized tracking mechanism that enables agents to monitor documents for updates, ensuring that AI-driven workflows remain synchronized with the most recent changes to team documentation.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface: clawhub install openclaw/skills/skills/nulltea/hackmd Additionally, ensure that the official HackMD CLI is installed globally on your system to handle the underlying API requests: npm install -g @hackmd/hackmd-cli

Use Cases

This skill is ideal for teams that utilize HackMD as their primary knowledge base. Common use cases include: 1) Automating the retrieval of documentation for RAG (Retrieval-Augmented Generation) pipelines, where the agent monitors specific notes for changes and updates context window content accordingly. 2) Managing team project status reports where an agent periodically pulls data from team notes to synthesize weekly summaries. 3) Maintaining synchronized project requirements, where an agent automatically pushes updates to a technical specification note whenever code commits are detected in a repository.

Example Prompts

1. "Check the document with ID 'v1-project-specs' for any recent changes and summarize the updates in a new note."
2. "List all notes in the 'Engineering' team space and tell me which ones were modified in the last 24 hours."
3. "Create a new team note in the 'Product' workspace titled 'Meeting Minutes' with the content from today's transcript."

Tips & Limitations

Be mindful of the rate limits associated with the HackMD API, which is restricted to 100 calls per 5 minutes and 2000 calls per month. For high-frequency tasks, always use the hackmd-track.js script to verify if a document has actually changed before pulling full content; this prevents unnecessary API overhead. The tracking state is saved locally in .hackmd/tracked-notes.json, so ensure your environment has persistence enabled for the working directory to maintain tracking continuity across session restarts.