A technical auditing utility that reconciles Flatnotes and Tasks.md data against GitHub PRs to ensure documentation and task accuracy.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install flatnotes-tasksmd-github-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install flatnotes-tasksmd-github-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Flatnotes + Tasks.md + GitHub Audit?
This skill provides a specialized auditing engine designed to maintain the integrity of a dual-system productivity stack consisting of Flatnotes for documentation and Tasks.md for project management. By leveraging the Openclaw Skills ecosystem, it ensures that your Kanban lanes remain hygienic, project documentation stays complete, and task statuses accurately reflect the reality of your GitHub pull requests. It bridges the gap between manual note-taking and automated source control metadata to prevent information drift within your workspace. As one of the most practical Openclaw Skills for developers, it automates the tedious process of cross-referencing PRs with task cards.
Flatnotes + Tasks.md + GitHub Audit Use Cases
- Auditing Tasks.md Kanban boards for lane rule violations and WIP limits using Openclaw Skills standards.
- Verifying that all active projects in the Project Registry have the required documentation notes like Overview, Research, Plan, and Log.
- Reconciling open and merged GitHub PRs with existing Tasks.md cards to identify missing updates or status mismatches.
- Identifying Tasks.md cards that are missing essential pointers to Flatnotes documentation.
- Enforcing priority-based lane placement, such as moving low-priority cards back to the backlog to reduce noise.
How Flatnotes + Tasks.md + GitHub Audit Works
- Parse the Project Registry within Flatnotes to identify active project slugs, status, and associated GitHub repository URLs.
- Index all cards in Tasks.md by lane and project tag, flagging formatting errors or missing documentation pointers.
- Scan the Flatnotes directory to ensure standardized note structures exist for every registered project.
- Query the GitHub API via the gh CLI to cross-reference open and recently merged pull requests against the task board.
- Generate a comprehensive Markdown and JSON report as part of the Openclaw Skills reporting suite detailing drift and violations.
Flatnotes + Tasks.md + GitHub Audit Setup
Ensure the GitHub CLI is authenticated and dependencies are available. Configure root paths via environment variables if using non-default locations as part of your Openclaw Skills deployment.
# Authenticate GitHub CLI for reconciliation
gh auth login
# Set custom paths (optional)
export TASKS_ROOT="/path/to/tasks"
export FLATNOTES_ROOT="/path/to/flatnotes"
# Run the auditor
node skills/flatnotes-tasksmd-github-audit/scripts/audit.mjs --since-days 30 --write
Flatnotes + Tasks.md + GitHub Audit Data Schema & Taxonomy
The skill interacts with local filesystem structures and generates specific reporting outputs to track system health within the Openclaw Skills ecosystem.
| Entity | Path/Source | Description |
|---|---|---|
| Tasks Root | /home/ds/.config/appdata/tasksmd/tasks |
The primary Kanban board source. |
| Flatnotes Root | /home/ds/.config/appdata/flatnotes/data |
Markdown-based project documentation. |
| Markdown Report | tmp/flatnotes-tasksmd-audit.md |
Human-readable audit summary. |
| JSON Report | tmp/flatnotes-tasksmd-audit.json |
Machine-readable audit data for other Openclaw Skills. |
Flatnotes + Tasks.md + GitHub Audit Advanced Features
- Automated fix application for creating missing documentation templates and ADR links.
- Heuristic matching between PR titles and Tasks.md card descriptions to find unlinked work automatically.
- Enforcement of complex lane rules, such as p2-priority cards being restricted from the active Next lane.
- Integrated GitHub CLI support for real-time reconciliation of shipped code vs. documented tasks.
- Support for custom environment variables to adapt to different self-hosted filesystem setups within the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
Workspace Cleaner
An automated maintenance utility designed to safely identify and remove temporary files, duplicates, and workspace clutter from your AI environment.
Vulnerability Scanner
A professional security analysis tool for identifying OWASP Top 10 vulnerabilities, supply chain risks, and hardcoded secrets.
Threat Modeling Expert
A professional security agent for architecting resilient systems using STRIDE, PASTA, and advanced risk assessment methodologies.
SQL Injection Testing
A comprehensive framework for identifying, exploiting, and mitigating SQL injection vulnerabilities in web applications.
gh-action-gen
gh-action-gen is an AI-powered CLI tool that transforms natural language descriptions into fully functional GitHub Actions workflow YAML files.
Giga Coding Agent
A high-performance skill for running background-first AI coding agents like Codex and Claude Code with directory isolation and parallel processing.
Featured*
