markdown-issues

Track team tasks as Markdown files in open, in_progress, and closed directories.

1|1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/EmmittJ/guild --skill markdown-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-issues
Source: https://github.com/EmmittJ/guild/tree/main/plugin/skills/setup/assets/skills/markdown-issues
Command: npx skills add https://github.com/EmmittJ/guild --skill markdown-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

File-based issue tracking for multi-agent teams, storing issues as Markdown files under ${issues_root}/open/, ${issues_root}/in_progress/, and ${issues_root}/closed/, enabling persistent context and audit trails without a runtime service.

Core Features & Use Cases

  • File-based workflow: issues are directories organized by status open, in_progress, and closed, with each issue as a Markdown file containing frontmatter for metadata.
  • Structured frontmatter: supports fields like type, priority, agent, created, and blocked-by to enable automation, filtering, and routing across sessions.
  • Context and audit: supports in-file notes and an archive in closed/ to preserve history and recover context between sessions.

Quick Start

Create the first issue by adding a Markdown file to the open directory with a descriptive title and frontmatter fields.

Frequently Asked Questions about markdown-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track team tasks using Markdown files without a database?

Track team tasks using Markdown files by organizing issues into open, in_progress, and closed directories. Each issue is a Markdown file with structured frontmatter like priority and agent, enabling persistent issue tracking without a runtime service.

What is file-based issue tracking for multi-agent workflows?

File-based issue tracking stores tasks as Markdown files in status directories, providing a persistent audit trail across multi-agent sessions. It uses structured frontmatter for automation and in-file notes to preserve context between workflow runs.

How do I create an issue and move it through open, in_progress, and closed directories?

Create an issue by adding a Markdown file with a descriptive title and frontmatter to the open directory. Update its status by moving the file to in_progress when claimed, then to closed when completed, maintaining an auditable history archive.

Can I filter and route Markdown issues automatically using frontmatter metadata?

Yes, you can filter and route Markdown issues using structured frontmatter fields like type, priority, agent, and blocked-by. These metadata fields enable automated task routing and filtering across multi-agent team workflows.

Does file-based issue tracking work for persistent context across sessions?

File-based issue tracking supports persistent context across sessions by storing issues as Markdown files with in-file notes and a closed archive. This maintains an auditable history and allows agents to recover task context without a database service.

What are the limitations of file-based Markdown issue tracking for teams?

File-based Markdown issue tracking lacks a runtime service, meaning concurrent edits may conflict and complex queries are limited to frontmatter field filtering. It suits teams needing readable audit trails over real-time multi-user collaboration.