fixme-tickets-md

Manage session-scoped bug tickets as markdown files with YAML frontmatter.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/denis-pingin/fixme --skill fixme-tickets-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fixme-tickets-md
Source: https://github.com/denis-pingin/fixme/tree/main/.claude/skills/fixme-tickets-md
Command: npx skills add https://github.com/denis-pingin/fixme --skill fixme-tickets-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Markdown-based ticket backend for fixme-session and fixme-task workflows, enabling per-session ticket tracking with markdown files and frontmatter.

Core Features & Use Cases

  • Ticket creation and session management via the fixme-tools.cjs CLI, storing tickets as ticket.md within session folders and organizing assets, research, plans, and verifications.
  • State transitions with a log and durations tracked in frontmatter to support retries and auditability.
  • Local, file-based orchestration that can be integrated with the broader fixme workflow.

Quick Start

Create a session, then create a ticket with a slug to generate ticket.md and manage it through transitions using fixme-tools.cjs commands.

Frequently Asked Questions about fixme-tickets-md

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

FAQPage Schema
How do I track bugs and tasks locally using markdown files?

Markdown-based ticket tracking stores bugs and tasks as ticket.md files within session folders, using YAML frontmatter to log state transitions and durations for auditability. It organizes assets, research, plans, and verifications to support plan-execute cycles.

How does frontmatter-based state management work for task transitions?

Frontmatter-based state management logs task transitions and durations directly in YAML frontmatter. This creates an auditable record of retries and lifecycle changes within the markdown store, ensuring persistent session-scoped state tracking.

What's the best way to orchestrate a plan-execute cycle for bug tracking?

Orchestrate plan-execute cycles by generating ticket.md files and organizing per-ticket assets, research, plans, and verifications. This structure supports continuous iteration and local task orchestration throughout the session.

Do I need a CLI tool to manage markdown ticket sessions?

Yes, ticket creation and session management rely on the fixme-tools.cjs CLI. It handles create, transition, and list operations, generating ticket.md files and managing the local file-based ticket store.

Can I use session-scoped ticket tracking for local workflow orchestration?

Yes, session-scoped ticket tracking provides local, file-based orchestration for bug tracking and task management. It operates per-session, integrating with broader workflows to manage state and transitions locally.

What are the limitations of file-based ticket backends for bug tracking?

File-based ticket backends operate locally per-session, meaning state and ticket.md files are stored on the local filesystem. This approach lacks centralized database synchronization, relying entirely on local file-based orchestration and YAML frontmatter for state persistence.