# Make Issue Spec

> Create a markdown document that describes a specific task along with

- Skill: `majiayu000/make-issue-spec` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/make-issue-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/make-issue-spec/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/make-issue-spec

---


---
name: make-issue-spec
description: Create a markdown document that describes a specific task along with
concise implementation plan, at issues/YYYYMMDD-blah-blah.md, where YYYYMMDD is based
on today's date.
---

# make-issue-spec

There isn't a lot more to this than what the top level description says. The idea is
for this issue spec to contain a clear specification of what is needed. Make sure to
ask the user any questions for parts that you're not sure of or are under specified.
Stage this in Git if you have permissions.