---
name: Make Issue Spec
slug: make-issue-spec
category: AI Engineering
description: Make Issue Spec creates a markdown document that clearly specifies a task, asking clarifying questions for underspecified parts and staging the file in Git when possible. Use it to define work for agents before implementation.
github: "https://github.com/pchalasani/claude-code-tools/tree/main/plugins/workflow/skills/make-issue-spec"
language: Python
stars: 1979
forks: 128
install: "npx degit https://github.com/pchalasani/claude-code-tools/tree/main/plugins/workflow/skills/make-issue-spec ~/.claude/skills/make-issue-spec"
installs_to: ~/.claude/skills/make-issue-spec
source_path: plugins/workflow/skills/make-issue-spec/SKILL.md
collection_size: 17
category_size: 2451
collection_url: "https://dirskills.com/collections/pchalasani/claude-code-tools"
added: 2026-08-18T06:58:52.784Z
last_synced: 2026-08-18T06:58:52.784Z
canonical_url: "https://dirskills.com/skills/make-issue-spec"
---

# Make Issue Spec

Make Issue Spec creates a markdown document that clearly specifies a task, asking clarifying questions for underspecified parts and staging the file in Git when possible. Use it to define work for agents before implementation.

**Install:**

```bash
npx degit https://github.com/pchalasani/claude-code-tools/tree/main/plugins/workflow/skills/make-issue-spec ~/.claude/skills/make-issue-spec
```

## README

# 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.