📋
AI EngineeringPython

Make Issue Spec

by pchalasani

Make Issue Spec is an AI Engineering skill for Claude Code, published by pchalasani in claude-code-tools.

2K stars128 forkson pchalasani/claude-code-toolsAdded 2026/08/18Repository updated 2026/08/17
claude-codeclicli-agentcode-agentcodexcodex-clicontextllmtmux
Install in seconds
Install Make Issue Spec
Copy Make Issue Spec into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/pchalasani/claude-code-tools/tree/main/plugins/workflow/skills/make-issue-spec ~/.claude/skills/make-issue-spec

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/pchalasani/claude-code-tools.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
plugins/workflow/skills/make-issue-spec/SKILL.md in pchalasani/claude-code-tools
Installs to
~/.claude/skills/make-issue-spec
Collection
One of 17 skills cataloged from this repository
Category
AI Engineering2451 skills

What Make Issue Spec does

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.

Make Issue Spec is cataloged under AI Engineering on DirSkills. Make Issue Spec comes from a repository tagged claude-code, cli, cli-agent, code-agent and codex.

Documentation

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.

Frequently asked about Make Issue Spec

  • What else does pchalasani publish alongside Make Issue Spec?

    Make Issue Spec is one of 17 skills that DirSkills catalogs from pchalasani/claude-code-tools, the repository it ships in. Its siblings there include Add Pattern, Agent Style and Avoid AI Writing. Each one is a separate skill with its own page in this directory, installs the same way Make Issue Spec does, and is maintained by pchalasani in that same repository. The rest of the collection is listed on the pchalasani/claude-code-tools page.

  • How does Make Issue Spec compare to other AI Engineering skills?

    Make Issue Spec ranks #875 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Make Issue Spec against them. Open each page to compare what they document and how they install.

More from pchalasani/claude-code-tools

Make Issue Spec is one of 17 skills cataloged on DirSkills from pchalasani/claude-code-tools.

See all 17 skills
🧩
2w ago

Add Pattern

Add Pattern records newly learned Langroid design patterns into the patterns library with a reference link and an implementation document. Use it when you discover a pattern to keep the catalog organized and searchable for future design problems.
AI Engineering
2K128
✍️
2w ago

Agent Style

Agent Style applies 21 literature-backed English technical-prose writing rules (passive voice, concrete language, needless words, citation discipline) for AI-assisted formal documents. Use when the user explicitly asks for agent-style by name for papers, design docs, proposals, READMEs, or commit messages.
Writing
2K128
✍️
2w ago

Avoid AI Writing

Avoid AI Writing audits and rewrites content to remove AI writing patterns (AI-isms) such as em-dash overuse, bold overuse, and excessive bullet lists. Use it when asked to remove AI-isms, clean up AI writing, or make text sound less like AI.
Writing
2K128
👣
2w ago

Code Walk Thru

Code Walk Thru opens files in the user's editor one by one at specific line numbers so they can follow along while the agent explains code or shows changes.
Automation
2K128
🔀
2w ago

Dynamic Workflow

Dynamic Workflow creates, runs, and manages durable JavaScript workflows that coordinate multiple headless Codex agents for fan-out/fan-in, multi-stage pipelines, and background runs. Use it when you need dynamic branching, looping, or long-running multi-agent work that a single model turn cannot handle directly.
Automation
2K128
🔔
2w ago

Issue Reply Wakeup

Issue Reply Wakeup registers an existing GitHub issue so the current Codex or Claude Code session is woken when its first future comment arrives. Use when work is blocked on a GitHub reply and the session must resume asynchronously.
Automation
2K128