Agent skill

Issue First

by ai-dynamo in ai-dynamo/dynamo

Ensures every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one.

Apache-2.0Auto-check passedDevelopment

Install Issue First

skills CLI
$ npx skills add ai-dynamo/dynamo --skill issue-first -a claude-code

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

GitHub CLI
$ gh skill install ai-dynamo/dynamo issue-first --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/ai-dynamo/dynamo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/issue-first .claude/skills/issue-first && 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
issue-first
GitHub stars
8.2k
Token cost
~980 tokens
SKILL.md length
539 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
Apache-2.0

At a glance

Ensures every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one.

  • Starting new work
  • SKILL.md covers Purpose, When to Use, Workflow and Related
  • Calls gh
  • Editing a pull request

What it does

Issue First is an agent skill from ai-dynamo/dynamo. Ensures every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one. Use when starting new work, opening or editing a pull request, or when the "PR Issue Link" check fails and needs remediation.

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 Development, covering Pull requests. It works with GitHub. The repository describes itself as: A Datacenter Scale Distributed Inference Serving Framework. The licence is Apache-2.0.

When your agent uses it

  • Starting new work
  • Editing a pull request
  • The PR Issue Link check fails and needs remediation

Example prompts

  • “PR Issue Link”
  • “Use the issue-first skill to ensure every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one”
  • “/issue-first”

What it can do on your machine

Read from SKILL.md and the folder at commit 5e82beb. 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

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    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

Issue First loads about 980 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 539 words of instructions outside code blocks.

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

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 ai-dynamo/dynamo at commit 5e82beb, republished under its Apache-2.0 licence (© ai-dynamo). 539 words, ~980 tokens.

Download SKILL.mdSave it as .claude/skills/issue-first/SKILL.md (or your agent's skills folder).
name
issue-first
description
Ensures every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one. Use when starting new work, opening or editing a pull request, or when the "PR Issue Link" check fails and needs remediation.
license
Apache-2.0
metadata.author
NVIDIA
metadata.tags
dynamo, github, linear, workflow

Skill: Issue-First Development

<!--
SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
SPDX-License-Identifier: CC-BY-4.0
-->

Purpose

Every pull request in this repository references the issue it implements, so work is traceable to a tracked task and release tracking stays live without manual reconciliation. The PR Issue Link CI check enforces this: advisory today, required from the date named in its failure message.

When to Use

  • Starting any new piece of work in this repository.
  • Opening a pull request, or editing one whose PR Issue Link check failed.
  • Deciding how to reference a DEP or another long-running tracking issue.

Workflow

Start From an Issue

Before writing code, find or create the issue for the work and start from it. The issue carries the context, the discussion history, and the record of why the change exists; an agent pointed at the issue first inherits all of it.

  • Community contributors: create or claim a GitHub issue on ai-dynamo/dynamo (gh issue create). Contributions are expected to have one.
  • NVIDIA engineers: start from the Linear issue. Creating the issue in the DGH Linear team mirrors it to GitHub automatically, and GitHub issues mirror back into DGH, so either side works.
  • Bug found mid-task that needs its own fix: create an issue for it rather than folding untracked work into the current PR.
  • Release features: each feature in a release has a tracking ticket in Linear with its work issues linked as Related, so that ticket is where to look up which feature a work issue belongs to.
Name the Branch

When a Linear issue exists, include its ID in the branch name (user/dyn-1234-short-description). Linear's GitHub integration links the PR from the branch name alone, and the CI check accepts it.

Show full SKILL.md (266 more words)Show less
Reference the Issue in the Pull Request

Put at least one of these in the PR title or description:

SituationReference form
This PR completes the issueFixes #123 or Closes DYN-1234
The issue outlives this PR (multi-PR feature, tracking issue)Part of #123 or refs DYN-1234
The work implements a DEPPart of #<dep> and a work issue of its own
The issue lives in a sibling org repositoryai-dynamo/<repo>#12 or the full issue URL

Closing keywords close the issue on merge; non-closing forms link without closing, which is what a multi-PR feature issue needs. The reference must point at a real issue: the check verifies existence and does not count pull-request numbers.

A DEP does not satisfy the check on its own. It is a proposal umbrella that stays open across many pull requests, so it records what the work is part of and not what one change is. Keep the Part of #<dep> reference and file a work issue for the change as well.

Remediate a Failing Check

The PR Issue Link check failing means no verifiable reference was found. Add one using the table above and edit the PR description; editing re-triggers the check. If no issue exists yet, create one first (see Start From an Issue). While the check is advisory it does not block merges; its failure message names the date it becomes required.

  • dep-create for proposing architecture changes as DEP issues. An implementing PR carries Part of #<dep> alongside its own work issue; the DEP reference alone fails the check.
  • The check's implementation lives at .github/workflows/pr-issue-link.yml and pr_issue_link.py.

© ai-dynamo, Apache-2.0. 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 .agents/skills/issue-first of ai-dynamo/dynamo.

Open the folder on GitHubat commit 5e82beb

Compare with similar skills

Issue First 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.

Issue First compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Issue First this skillai-dynamo/dynamo8.2k—~980Automated safety check: PassApache-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Pull Request Title and Body Writeropeninterpreter/openinterpreter69k2 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Runs a loop on a GitHub pull request: fetch review state, triage comments into actions, implement them and resolve threads, repeating until nothing actionable is left.

    48k GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from ai-dynamo/dynamo

All 27 skills in this repo
  • Visual Review

    ai-dynamo/dynamo

    Create self-contained interactive HTML code-review dashboards from GitHub or GitLab pull requests, checked-out branch diffs, or supplied unified diffs, with correctness and safe-to-merge scores…

    8.2k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Fern Components

    ai-dynamo/dynamo

    Knowledge of Fern's built-in MDX component library (accordions, callouts, cards, steps, tabs, code blocks, API-reference snippets, and more) for authoring docs pages.

    8.2k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Fern Navigation

    ai-dynamo/dynamo

    Knowledge of Fern's site-level navigation and structure configuration — how a docs site is organized in docs.yml (and product/version .yml files) using sections, pages, folders, tabs, tab variants…

    8.2k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Dynamo Agent Harness

    ai-dynamo/dynamo

    Drives persistent Claude Code, Codex, or OpenCode agent sessions through a Dynamo OpenAI/Anthropic-compatible endpoint over Agent Client Protocol (ACP).

    8.2k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Benchmark and profile the Dynamo frontend (dynamo.frontend HTTP + tokenizer + KV router) against mock workers (dynamo.mocker).

    8.2k GitHub stars~3.5k tokensUpdated today
    Auto-check: notes
  • Selects and freezes a question-driven AIPerf workload, objective, load policy, and Kubernetes execution manifest for a successfully deployed Dynamo candidate.

    8.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Issue First

What does Issue First do?

Ensures every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one. Issue First is an agent skill from ai-dynamo/dynamo. Ensures every piece of work in ai-dynamo/dynamo starts from a tracked issue and every pull request references one.

When should I use Issue First?

Issue First fits situations like: starting new work; editing a pull request; the PR Issue Link check fails and needs remediation.

How do I install Issue First in Claude Code?

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

How do I install Issue First in Codex?

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

Can I use Issue First 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 ai-dynamo/dynamo --skill issue-first -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/issue-first, .gemini/skills/issue-first, .github/skills/issue-first and .opencode/skills/issue-first in your project.

What does Issue First need to run?

Going by SKILL.md and its folder, Issue First needs the command-line tools its instructions call (gh).

Does Issue First access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Issue First 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 Issue First use?

Issue First is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Issue First use?

About 980 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 Issue First?

Skills that share tags, products or a category with Issue First: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Check PR (onyx-dot-app/onyx, 32k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Create Pull Request (cline/cline, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Issue First?

ai-dynamo (a GitHub organization) maintains it in ai-dynamo/dynamo, which has 8,238 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 7, 2026.

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