Agent skill

Make Tracking Issue

by remix-run in remix-run/remix

Create or revise a GitHub tracking issue for a Remix change, including the target outcome, implementor context, a concise checkbox plan, compatibility concerns, and required gates.

MITAuto-check passedDevelopment

Install Make Tracking Issue

skills CLI
$ npx skills add remix-run/remix --skill make-tracking-issue -a claude-code

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

GitHub CLI
$ gh skill install remix-run/remix make-tracking-issue --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/remix-run/remix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/make-tracking-issue .claude/skills/make-tracking-issue && 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
make-tracking-issue
GitHub stars
33k
Token cost
~1.3k tokens
SKILL.md length
598 words
Files
2
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Create or revise a GitHub tracking issue for a Remix change, including the target outcome, implementor context, a concise checkbox plan, compatibility concerns, and required gates.

  • Works in 5 steps: Inspect the relevant code, package… → Capture decisions already made by the… → Confirm the target repository from the… → …
  • The user asks to open
  • SKILL.md covers Overview, Workflow, Issue Structure and Quality Rules, plus 1 more section
  • Calls gh

What it does

Make Tracking Issue is an agent skill from remix-run/remix. Create or revise a GitHub tracking issue for a Remix change, including the target outcome, implementor context, a concise checkbox plan, compatibility concerns, and required gates. Use when the user asks to open, draft, rewrite, or tighten a tracking issue, implementation issue, umbrella issue, or work plan in the Remix repository.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development. It works with GitHub and Remix. The repository describes itself as: The fully-stacked web framework. The licence is MIT.

When your agent uses it

  • The user asks to open
  • Tighten a tracking issue
  • Implementation issue
  • Work plan in the Remix repository

Example prompts

  • “/make-tracking-issue”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the relevant code, package metadata, docs, and existing tests until the current state and affected boundaries are concrete.
  2. Capture decisions already made by the user. Do not reopen them as alternatives or weaken them with speculative language.
  3. Confirm the target repository from the git remote, search for duplicate issues, and inspect issue templates or labels when they may affect…
  4. Draft the issue using the structure below, omitting sections that add no value.
  5. Create or edit the issue with gh, then read it back to verify the title, body, state, and URL.

What it can do on your machine

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

Make Tracking Issue loads about 1.3k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 598 words of instructions outside code blocks.

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

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 remix-run/remix at commit 27bd7a4, republished under its MIT licence (© remix-run). 598 words, ~1,290 tokens.

Download SKILL.mdSave it as .claude/skills/make-tracking-issue/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
make-tracking-issue
description
Create or revise a GitHub tracking issue for a Remix change, including the target outcome, implementor context, a concise checkbox plan, compatibility concerns, and required gates. Use when the user asks to open, draft, rewrite, or tighten a tracking issue, implementation issue, umbrella issue, or work plan in the Remix repository.

Make Tracking Issue

Overview

Create a focused handoff that explains what must change and how completion will be judged without turning the issue into a prescriptive implementation specification.

Use gh for GitHub reads and writes. Creating or editing an issue is an external write, so only perform it when the user asks for the issue to be created or updated. Otherwise, return a draft.

Workflow

  1. Inspect the relevant code, package metadata, docs, and existing tests until the current state and affected boundaries are concrete.
  2. Capture decisions already made by the user. Do not reopen them as alternatives or weaken them with speculative language.
  3. Confirm the target repository from the git remote, search for duplicate issues, and inspect issue templates or labels when they may affect the result.
  4. Draft the issue using the structure below, omitting sections that add no value.
  5. Create or edit the issue with gh, then read it back to verify the title, body, state, and URL.

Issue Structure

Title

Name the concrete outcome and affected area. Prefer Refactor @remix-run/test to ... over vague titles such as Improve test architecture.

Summary

State the current problem, desired end state, and why the change matters. Include a compact dependency or execution flow when ownership boundaries are central to the work.

Context and requirements

Give the implementor the non-obvious facts needed to work safely:

  • Current and target ownership boundaries
  • Public APIs, commands, or package exports that must remain available
  • Compatibility and migration expectations
  • Dependency-direction constraints
  • Defaults or behavior that must not change
  • Explicit non-goals

Keep requirements semantic. Avoid locking in exact type shapes, helper names, file layouts, or parsing implementations unless the repository or user has already decided them.

Implementation plan

Write one flat checklist containing the work outcomes required to complete the change.

  • Use checkboxes only in this section.
  • Keep each item to one concise sentence.
  • Be thorough enough to cover implementation, integration, tests, docs, packaging, and release notes when applicable.
  • Describe what must be accomplished, not the exact sequence of edits or internal design.
  • Avoid nested checklists, per-file recipes, proposed interfaces, and command-by-command instructions.

Good:

markdown
- [ ] Move test-command parsing and help behavior into `@remix-run/cli`.
- [ ] Remove the standalone executable and migrate repository consumers.
- [ ] Update integration and packaging coverage for the new boundary.

Too prescriptive:

markdown
- [ ] Add `multiple: true` to `ParseArgsStringOptionSpec` in `parse-args.ts`.
- [ ] Rename `loadConfig(argv, cwd)` to `loadResolvedConfig(options, cwd)`.
Show full SKILL.md (246 more words)Show less
Required gates

List acceptance criteria as ordinary bullets, not checkboxes. Cover the narrow package checks and broader repository checks required by AGENTS.md, plus meaningful smoke or packaging verification.

Prefer outcome language when the exact command is not important:

markdown
- Test-package tests, typecheck, and build pass.
- Package metadata validation passes.
- The packed package exposes the intended API and no removed executable.

Use exact commands only when they are established repository gates or prevent ambiguity.

Additional context

Add migration examples, release impact, likely affected areas, or out-of-scope notes only when they materially help implementation. Keep historical changelog entries and unrelated cleanup out of scope unless requested.

Quality Rules

  • Lead with the desired outcome, not a chronology of investigation.
  • Separate implementation tasks from acceptance gates.
  • Preserve the user's chosen architecture and terminology.
  • Distinguish public behavior from internal implementation freedom.
  • Call out breaking changes and provide a migration path.
  • Do not inflate the issue with exhaustive flag, file, or test-case inventories when a grouped requirement is sufficient.
  • Do not add labels merely because they exist; use only labels that accurately communicate repository workflow or ownership.
  • Avoid creating a general abstraction as part of a focused tracking issue unless the requested change requires it.

Before Finishing

  • Is the title specific enough to scan in an issue list?
  • Can an implementor explain the current state, target state, and ownership boundary after reading the summary?
  • Is the implementation plan a single flat checkbox list of outcomes?
  • Are gates plain bullets with no checkboxes?
  • Are compatibility, migration, release, and non-goal details included only where useful?
  • Did gh issue view confirm the final issue content and URL?

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

Files

SKILL.md and 1 other file in .agents/skills/make-tracking-issue of remix-run/remix.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 27bd7a4

Compare with similar skills

Make Tracking Issue 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.

Make Tracking Issue compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Make Tracking Issue this skillremix-run/remix33k—~1.3kAutomated safety check: PassMIT
Releaseseasonedcc/remix-forms514—~1.3kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Setup Matt Pocock Skillsbestofjs/bestofjs3.1k20 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Release

    seasonedcc/remix-forms

    Release a new version of the remix-forms npm package. An agent skill from seasonedcc/remix-forms.

    514 GitHub stars~1.3k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • 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
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k 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
  • Setup Matt Pocock Skills

    bestofjs/bestofjs

    Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout.

    3.1k GitHub starsUsed in 20 repos~1.7k 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

More from remix-run/remix

All 19 skills in this repo
  • Supersede PR

    remix-run/remix

    Safely replace one GitHub pull request with another. An agent skill from remix-run/remix.

    33k GitHub stars~456 tokensUpdated yesterday
    Auto-check passed
  • Add Package

    remix-run/remix

    Create or align a package in the Remix monorepo to match existing package conventions.

    33k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Author UI Primitives

    remix-run/remix

    Build idiomatic headless primitives in packages/ui for Remix.

    33k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Fix Issue

    remix-run/remix

    Fix a reported issue in Remix from a GitHub issue. An agent skill from remix-run/remix.

    33k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Make Demo

    remix-run/remix

    Create or revise demos in the Remix repository. An agent skill from remix-run/remix.

    33k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Make PR

    remix-run/remix

    Create GitHub pull requests with clear, reviewer-friendly descriptions.

    33k GitHub stars~847 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Make Tracking Issue

What does Make Tracking Issue do?

Create or revise a GitHub tracking issue for a Remix change, including the target outcome, implementor context, a concise checkbox plan, compatibility concerns, and required gates. Make Tracking Issue is an agent skill from remix-run/remix. Create or revise a GitHub tracking issue for a Remix change, including the target outcome, implementor context, a concise checkbox plan, compatibility concerns, and required gates.

When should I use Make Tracking Issue?

Make Tracking Issue fits situations like: the user asks to open; tighten a tracking issue; implementation issue; work plan in the Remix repository.

How do I install Make Tracking Issue in Claude Code?

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

How do I install Make Tracking Issue in Codex?

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

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

What does Make Tracking Issue need to run?

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

Does Make Tracking Issue 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 Make Tracking Issue 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 Make Tracking Issue use?

Make Tracking Issue 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 Make Tracking Issue use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 Make Tracking Issue?

Skills that share tags, products or a category with Make Tracking Issue: Release (seasonedcc/remix-forms, 514 stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars), Greploop (onyx-dot-app/onyx, 32k stars) and Check PR (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Make Tracking Issue?

remix-run (a GitHub organization) maintains it in remix-run/remix, which has 33,396 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 6, 2026.

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