Skip to main content
affpapa.org
RU EN
skill CX Codex

make-issue-spec — Claude Code skill: what it does, how to install

Generates a markdown task specification and implementation plan in issues/. Adds the file to Git staging if permissions allow.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add pchalasani/claude-code-tools --skill make-issue-spec -a claude-code
Open on GitHub

What make-issue-spec does

This skill creates a markdown document containing a concrete task description and a concise implementation plan. The file is saved at issues/YYYYMMDD-blah-blah.md, using the current date in the filename prefix.

The workflow focuses on clarity. Whenever input details are missing or ambiguous, the agent stops to ask clarifying questions before writing the spec.

Staging the document via Git requires working repository permissions in the active workspace.

What it helps with

  • Document task requirements in markdown
  • Generate a concise implementation plan before coding
  • Stage the prepared issue document in Git

Example prompts for the agent

  • Create an issue spec for adding redis caching using make-issue-spec
  • Draft a task plan for the database migration in issues/

How to install make-issue-spec

1Skills CLI (Vercel)

npx skills add pchalasani/claude-code-tools --skill make-issue-spec -a claude-code

2Manually: put the files in place

~/.claude/skills/make-issue-spec/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/make-issue-spec/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about make-issue-spec

How to install make-issue-spec in Claude Code?

Run npx skills add pchalasani/claude-code-tools --skill make-issue-spec -a claude-code. The skill file is placed into ~/.claude/skills/make-issue-spec/SKILL.md.

Where are task specifications stored?

Files are created in the issues/ folder using the date-based pattern issues/YYYYMMDD-blah-blah.md.

What happens if a task is under-specified?

The agent asks clarifying questions about any ambiguous parts before finalizing the file.

Source text

SKILL.md · MIT 
---
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.

© pchalasani · MIT · pchalasani/claude-code-tools

Similar skills

All skills for Notes, tasks and projects →
find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. 862,247installs

From the same set15

remove-ai-patterns Detects and removes generative writing cliches using the avoid-ai-writing catalog. Useful when drafting copy that needs a natural tone without synthetic phrasing. CX Codex +1 ★ 2,021repo stars agent-style This skill guides formal technical writing in English. Invoke it by name when drafting or revising a paper, README, proposal, or design document. CX Codex +1 ★ 2,021repo stars socratic-quiz The skill walks you through a topic with one question at a time instead of handing over the answer. Useful when you want to actually understand something, not just read it. CX Codex +1 ★ 2,021repo stars log-work The skill records a concise account of completed work in WORKLOG/YYYYMMDD.md, with references to files that hold more detail. Use it to keep a dated project log for people and AI agents. CX Codex +1 ★ 2,021repo stars code-walk-thru The skill makes the agent open files in your editor one at a time, at the exact line, so you can follow a code walkthrough or review its changes. CX Codex +1 ★ 2,021repo stars voice-update Speaks a short audio summary of completed tasks using pocket-tts. Useful when monitoring background runs without watching the screen. CX Codex +1 ★ 2,021repo stars tmux-cli This skill lets an agent work with CLI agents and scripts in other tmux panes. Use it for shell commands, exit-code checks, and pane-to-pane communication. CX Codex +1 ★ 2,021repo stars msg This skill hands your agent a msg CLI for talking to other Claude and Claude sessions, reading incoming messages and coordinating across tmux panes. CX Codex +1 ★ 2,021repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor