md-issue-writer

Generate standardized markdown issue documents with YAML frontmatter and templates.

5|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/arisng/github-copilot-fc --skill md-issue-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md-issue-writer
Source: https://github.com/arisng/github-copilot-fc/tree/main/skills/md-issue-writer
Command: npx skills add https://github.com/arisng/github-copilot-fc --skill md-issue-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill helps teams draft consistent markdown issue documents (Bug, Feature Plan, RFC, ADR, Task, Retrospective) quickly and reliably, reducing manual formatting overhead.

Core Features & Use Cases

  • Template-driven document creation for multiple issue types.
  • Automated index/metadata extraction with scripts/extract_issue_metadata.py.
  • Reference templates in references/templates.md to ensure consistency.
  • Easy integration with existing workflows in .docs/issues/ or _docs/issues/ folders.

Quick Start

Run the following command to create a new Bug document: python scripts/create_issue.py --type "Bug" --title "Sample bug" --description "Describe the issue here" --severity "Medium" --status "Draft"

Frequently Asked Questions about md-issue-writer

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

FAQPage Schema
How do I generate standardized markdown issue documents for software projects?

You can generate standardized markdown issue documents by running the Python script create_issue.py with parameters for type, title, description, severity, and status to automatically create files with consistent YAML frontmatter and directory placement.

Can I automate the creation of RFC and ADR records in markdown?

Yes, you can automate the creation of RFC and ADR records by executing the Python script with the specific issue type argument, which uses reference templates to ensure consistent formatting and governance across your team.

How do I extract metadata from markdown issue files in my repository?

You extract metadata from markdown issue files by running the scripts/extract_issue_metadata.py script, which parses the YAML frontmatter and document contents to automatically generate an organized index of your issues.

Does the markdown issue generation require a specific folder structure?

Yes, the markdown issue generation targets the .docs/issues/ or _docs/issues/ directory structure to support consistent governance and organization across software project teams.

What is the best way to maintain consistent YAML frontmatter across bug reports?

The best way to maintain consistent YAML frontmatter across bug reports is to use template-driven document creation scripts that automatically inject required date, type, severity, and status fields into your markdown files.

What issue types are supported by markdown issue templates?

The markdown issue templates support Bug, Feature Plan, RFC, ADR, Task, and Retrospective records to help teams draft consistent documentation and reduce manual formatting overhead.