arisng/md-issue-writer
skills/md-issue-writer/SKILL.md
Create and draft markdown-based issue documents (bug reports, feature plans, RFCs, ADRs, tasks, retrospectives) in the top-level `.issues/` folder. Use this skill whenever you need to document software issues, feature proposals, architectural decisions, work items, or post-mortems. Includes templates, metadata indexing, and structured YAML frontmatter. Different from issue tracker systems — this is for archival, decision-making, and knowledge base documents.
$ install --global
skillsauthnpx skillsauth add arisng/github-copilot-fc md-issue-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 12, 2026, 3:14 AM129.8s10 files scanned
SKILL.md
- name:
- md-issue-writer
- description:
- Create and draft markdown-based issue documents (bug reports, feature plans, RFCs, ADRs, tasks, retrospectives) in the top-level `.issues/` folder. Use this skill whenever you need to document software issues, feature proposals, architectural decisions, work items, or post-mortems. Includes templates, metadata indexing, and structured YAML frontmatter. Different from issue tracker systems — this is for archival, decision-making, and knowledge base documents.
- version:
- 2.2.0
- author:
- arisng
MD Issue Writer
Overview
This skill enables the creation of concise, one-page technical documents for software issues, features, decisions, and work items. Each document follows a standardized YAML frontmatter and markdown structure, making them discoverable and indexable across the knowledge base.
When to Use Each Document Type
Use this decision tree to select the right template:
| Situation | Document Type | Purpose | |---|---|---| | Something broke or isn't working | Bug Report | Root cause analysis, prevention, lessons learned | | Build/ship a new capability | Feature Plan | Goals, requirements, implementation approach, risks | | Need consensus on architectural direction | RFC | Proposal, motivation, design, alternatives, Q&A | | Made a major technical decision | ADR | Document the decision, context, and consequences | | Have specific work to accomplish | Task | Objectives, acceptance criteria, checklist | | Learned something from an incident/project | Retrospective | What happened, what went well, lessons, actions |
Workflow
- Choose the document type using the decision tree above or by reviewing the templates in
templates/. - Gather required metadata: title, description, severity (if applicable), status, author (if applicable).
- Generate the document using the provided script or by copying a template into the new
.issues/directory (it will be created automatically). - Fill in the content following the template structure.
- (Optional) Index all documents by running the metadata extraction script to keep the central index current.
Usage
Create a new issue document via script:
python scripts/create_issue.py --type "Bug" --title "Fix login timeout" --description "Users are logged out after 5 minutes" --severity "High"
Or copy a template directly:
cp templates/<type>.md .issues/<date>_<slug>.md
To extract metadata and regenerate the index of all issues:
python scripts/extract_issue_metadata.py
Template Reference
Each issue type has its own reference file in templates/:
- bug-report.md — Incident analysis with root cause, solution, and prevention steps
- feature-plan.md — Feature proposal with goals, requirements, and implementation approach
- rfc.md — RFC proposal with motivation, design, alternatives, and open questions
- adr.md — Architecture decision record for major technical choices
- task.md — Work item with objectives, acceptance criteria, and references
- retrospective.md — Post-incident or post-project learning document
See templates/index.md for a complete overview and quick-reference guide.
Resources
scripts/
create_issue.py— Generate issue documents based on templatesextract_issue_metadata.py— Extract metadata and regenerate the index
templates/
index.md— Quick reference and overview of all template typesbug-report.md,feature-plan.md,rfc.md,adr.md,task.md,retrospective.md— Individual templates
Related Skills
arisng/tldraw-creator
devops
VerifiedTrustedCommunity
Programmatically create tldraw whiteboards and visualize them with a self-hosted tldraw instance. Create boards with shapes, text, and connectors, then deploy to a self-hosted server for collaborative editing and gallery management.
3SKILL.mdUpdated May 30, 2026
arisng/gcloud-cli
tools
VerifiedTrustedCommunity
Execute Google Cloud Platform operations using the gcloud CLI (and gsutil/bq where applicable). Use when the user wants to: authenticate with GCP, manage GCP resources, deploy applications, configure projects or IAM, view logs, run SQL/BigQuery, or interact with any GCP service from the command line. Triggers on phrases like "gcloud", "Google Cloud CLI", "deploy to GCP", "create a VM", "Cloud Run", "GKE cluster", "Cloud Storage bucket", "set GCP project", "service account", "Cloud Functions", "App Engine deploy", or any request to manage Google Cloud resources via command line.
3SKILL.mdUpdated May 29, 2026
arisng/grill-with-docs
testing
VerifiedTrustedCommunity
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
3SKILL.mdUpdated May 26, 2026
arisng/git-session-atomic-commits
development
VerifiedTrustedCommunity
Session-scoped git commit orchestrator that commits only current-session changes and leaves unrelated dirty worktree edits untouched. Inherits git-atomic-commit for atomic grouping and commit message execution, and git-commit-scope-constitution for scope governance and validation. Use when asked to commit this session only or isolate commits from mixed worktree state.
3SKILL.mdUpdated May 23, 2026