New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

First Issue Designer

by mohitagw15856 in mohitagw15856/pm-claude-skills

A skill your agent uses when asked to create good first issues, prepare a repo for new contributors, turn a roadmap into starter tasks, or write issues that newcomers can actually finish.

MITAuto-check passedProduct & Project Management

Install First Issue Designer

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill first-issue-designer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills first-issue-designer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/first-issue-designer .claude/skills/first-issue-designer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
first-issue-designer
GitHub stars
1.4k
Token cost
~977 tokens
SKILL.md length
453 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when asked to create good first issues, prepare a repo for new contributors, turn a roadmap into starter tasks, or write issues that newcomers can actually finish.

  • Works in 4 steps: Candidate scan → The issues (8 to 12) → Mix check → …
  • Asked to create good first issues
  • SKILL.md covers Required Inputs, Output Structure, Quality Checks and Anti-Patterns, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

First Issue Designer is an agent skill from mohitagw15856/pm-claude-skills. Use when asked to create good first issues, prepare a repo for new contributors, turn a roadmap into starter tasks, or write issues that newcomers can actually finish. Produces 8 to 12 good first issues from a codebase and roadmap, each with context, acceptance criteria, files to touch and an effort estimate, plus the labels and a short pinned welcome note. For the CONTRIBUTING guide itself, use contributor-guide.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering Open source maintenance and User stories. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked to create good first issues
  • Prepare a repo for new contributors
  • Turn a roadmap into starter tasks
  • Write issues that newcomers can actually finish

Example prompts

  • “/first-issue-designer”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Candidate scan
  2. The issues (8 to 12)
  3. Mix check
  4. Pinned welcome note

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

First Issue Designer loads about 977 tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 453 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~977

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 453 words, ~977 tokens.

Download SKILL.mdSave it as .claude/skills/first-issue-designer/SKILL.md (or your agent's skills folder).
name
first-issue-designer
description
Use when asked to create good first issues, prepare a repo for new contributors, turn a roadmap into starter tasks, or write issues that newcomers can actually finish. Produces 8 to 12 good first issues from a codebase and roadmap, each with context, acceptance criteria, files to touch and an effort estimate, plus the labels and a short pinned welcome note. For the CONTRIBUTING guide itself, use contributor-guide.
version
1.0.0

First Issue Designer

A good first issue is a small, real task that a stranger can finish in one sitting without asking the maintainer anything. Most "good first issue" labels sit on tasks that are vague, secretly large, or blocked on a decision only the maintainer can make. This skill reads the codebase and roadmap and writes 8 to 12 issues that newcomers can pick up and finish.

Required Inputs

Ask for these if not provided:

  • The repo: structure, main language, how to run tests
  • The roadmap or backlog: what the maintainer wants done next
  • Things the maintainer does not want touched: core modules, areas mid-refactor
  • Review capacity: how many PRs a week the maintainer can review
  • Existing labels and any CONTRIBUTING guide

Output Structure

1. Candidate scan

A table of possible tasks found in the roadmap, TODO comments, failing or missing tests, docs gaps and small bugs: | Candidate | Source | Size guess | Keep or drop | Reason |

Drop anything that needs a design decision, touches more than three files, or depends on another open task.

2. The issues (8 to 12)

Each issue in this exact format, ready to paste:

markdown
**Title:** [Verb] [object] in [place]   (e.g. "Add a --json flag to the export command")

**Context**
[Two or three sentences: why this matters to users and where it fits.]

**What to do**
1. [Step]
2. [Step]

**Acceptance criteria**
- [ ] [Observable result]
- [ ] [Test added or updated: name the test file]
- [ ] [Docs updated, if user-facing]

**Files to touch**
- `path/to/file` (what changes there)

**Effort:** [about 1 hour | about 2 hours | half a day]
**Skills needed:** [e.g. basic TypeScript, no framework knowledge]
**Labels:** good first issue, [area label]
3. Mix check

A table showing the spread across types (docs, tests, small feature, bug, tooling) and effort. Aim for at least three issues under two hours and no more than two at half a day.

4. Pinned welcome note

A short note (under 120 words) for a pinned issue or discussion: how to claim an issue, how long a claim lasts, where to ask, and how quickly PRs are reviewed, matching the stated review capacity.

Show full SKILL.md (188 more words)Show less

Quality Checks

  • Between 8 and 12 issues, each in the exact format above
  • Every issue names the files to touch and at least one test or doc to update
  • Every acceptance criterion is observable (a command, output or page someone can check)
  • No issue requires a decision the maintainer has not made
  • No issue touches more than three files or depends on another open issue
  • At least three issues are estimated at two hours or less
  • The welcome note's review promise matches the stated review capacity

Anti-Patterns

  • "Improve the docs". Too vague to finish. Name the page and the missing section.
  • Hidden epics. A "small" refactor that ripples through ten files discourages first-timers.
  • Issues only the maintainer could do. If it needs context from a private conversation, it is not a first issue.
  • Promising fast reviews you cannot give. A PR left for a month loses the contributor.

Example Trigger Phrases

  • "Create good first issues for my repo from this roadmap."
  • "I want contributors. Write 10 starter issues newcomers can finish."
  • "Turn these TODO comments into good first issues with acceptance criteria."
  • "Prepare my project for Hacktoberfest-style contributors."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/first-issue-designer of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

First Issue Designer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

First Issue Designer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
First Issue Designer this skillmohitagw15856/pm-claude-skills1.4k—~977Automated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
To Specbestofjs/bestofjs3.1k21 repos~757Automated safety check: PassMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed

  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed

  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed

  • Ralph Tui Create Beads Rust

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed

  • To Spec

    bestofjs/bestofjs

    Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

    3.1k GitHub starsUsed in 21 repos~757 tokens
    Product & Project ManagementAuto-check passed

  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo

  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about First Issue Designer

What does First Issue Designer do?

A skill your agent uses when asked to create good first issues, prepare a repo for new contributors, turn a roadmap into starter tasks, or write issues that newcomers can actually finish. First Issue Designer is an agent skill from mohitagw15856/pm-claude-skills. Use when asked to create good first issues, prepare a repo for new contributors, turn a roadmap into starter tasks, or write issues that newcomers can actually finish.

When should I use First Issue Designer?

First Issue Designer fits situations like: asked to create good first issues; prepare a repo for new contributors; turn a roadmap into starter tasks; write issues that newcomers can actually finish.

How do I install First Issue Designer in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill first-issue-designer -a claude-code`. Or copy the skill folder (skills/first-issue-designer in mohitagw15856/pm-claude-skills) into .claude/skills/first-issue-designer in your project. Claude Code loads it when a task matches its description.

How do I install First Issue Designer in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill first-issue-designer -a codex`. Or copy the skill folder (skills/first-issue-designer in mohitagw15856/pm-claude-skills) into .agents/skills/first-issue-designer in your project. Codex loads it when a task matches its description.

Can I use First Issue Designer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill first-issue-designer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/first-issue-designer, .gemini/skills/first-issue-designer, .github/skills/first-issue-designer and .opencode/skills/first-issue-designer in your project.

What does First Issue Designer need to run?

SKILL.md names no scripts, command-line tools or credentials: First Issue Designer is instructions for the agent only.

Does First Issue Designer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is First Issue Designer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does First Issue Designer use?

First Issue Designer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does First Issue Designer use?

About 977 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to First Issue Designer?

Skills that share tags, products or a category with First Issue Designer: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Agile Product Owner (alirezarezvani/claude-skills, 28k stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains First Issue Designer?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.