Official agent skill

Triage Issues

by kubernetes-sigs in kubernetes-sigs/agent-sandbox

Triage open GitHub issues for kubernetes-sigs/agent-sandbox by mapping them to roadmap.md and assigning k8s priority labels + Kanban Priority (P0–P4) on Project

OfficialApache-2.0Auto-check passedDevOps & Cloud

Install Triage Issues

skills CLI
$ npx skills add kubernetes-sigs/agent-sandbox --skill triage-issues -a claude-code

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

GitHub CLI
$ gh skill install kubernetes-sigs/agent-sandbox triage-issues --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/kubernetes-sigs/agent-sandbox.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/triage-issues .claude/skills/triage-issues && 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
triage-issues
GitHub stars
4.2k
Token cost
~1.5k tokens
SKILL.md length
725 words
Files
5
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Triage open GitHub issues for kubernetes-sigs/agent-sandbox by mapping them to roadmap.md and assigning k8s priority labels + Kanban Priority (P0–P4) on Project

  • Works in 6 steps: Honor existing priority/* labels — do… → Roadmap references — if the issue number… → Bug severity — data-integrity /… → …
  • Tasks that involve Container orchestration
  • SKILL.md covers Label ↔ Priority mapping (fixed), Key references, Triage heuristics and Procedure, plus 2 more sections
  • Runs Python scripts from its folder; calls gh

What it does

Triage Issues is an agent skill from kubernetes-sigs/agent-sandbox, published by the product's own GitHub organization. Triage open GitHub issues for kubernetes-sigs/agent-sandbox by mapping them to roadmap.md and assigning k8s priority labels + Kanban Priority (P0–P4) on Project

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files (for example `evals/eval_runner.py`, `evals/evals.json` and `evals/files/open_issues.json`).

It sits in DevOps & Cloud, covering Container orchestration, Issue triage and Task management. It works with Kubernetes and GitHub. The repository describes itself as: agent-sandbox enables easy management of isolated, stateful, singleton workloads, ideal for use cases like AI agent runtimes and reinforcement learning (RL). The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Container orchestration
  • Tasks that involve Issue triage
  • Tasks that involve Task management

Example prompts

  • “/triage-issues”

Requirements

  • Python 3

Workflow steps

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

  1. Honor existing priority/* labels — do not downgrade/overwrite an existing priority label unless the issue clearly changed; note any you…
  2. Roadmap references — if the issue number is cited in roadmap.md, inherit that item's status: ⏳ In Progress → P1, 📅 Planned → P2, ✅…
  3. Bug severity — data-integrity / duplicate-resource / resource-leak bugs in the core controller → P0/P1. Self-labeled "Critical" → P0.
  4. Value props — latency / performance / scale bottlenecks skew P1 (called out as a primary value proposition).
  5. Security — critical security vulnerabilities / CVEs → P0 (priority/critical-urgent); routine dependency/patch updates → P1 (tied to…
  6. Low-signal — empty bodies, one-line questions, "collecting use cases", pinned/frozen community threads, items marked…

What it can do on your machine

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

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • gh

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Triage Issues loads about 1.5k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 725 words of instructions outside code blocks.

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

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 kubernetes-sigs/agent-sandbox at commit cd0761d, republished under its Apache-2.0 licence (© kubernetes-sigs). 725 words, ~1,491 tokens.

Download SKILL.mdSave it as .claude/skills/triage-issues/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
triage-issues
description
Triage open GitHub issues for kubernetes-sigs/agent-sandbox by mapping them to roadmap.md and assigning k8s priority labels + Kanban Priority (P0–P4) on Project

Triage agent-sandbox issues against the roadmap

Map every open issue in kubernetes-sigs/agent-sandbox to a roadmap theme/item, assign a triage priority, and sync that priority to both the issue's k8s priority/* label and the Priority field (P0–P4) on the Kanban board.

Label ↔ Priority mapping (fixed)

k8s labelKanban Priority
priority/critical-urgentP0
priority/important-soonP1
priority/important-longtermP2
priority/backlogP3
priority/awaiting-more-evidenceP4

Key references

Triage heuristics

Assign each open issue a tier using, in order:

  1. Honor existing priority/* labels — do not downgrade/overwrite an existing priority label unless the issue clearly changed; note any you keep.
  2. Roadmap references — if the issue number is cited in roadmap.md, inherit that item's status: ⏳ In Progress → P1, 📅 Planned → P2, ✅ Completed follow-ups → P2/P3.
  3. Bug severity — data-integrity / duplicate-resource / resource-leak bugs in the core controller → P0/P1. Self-labeled "Critical" → P0.
  4. Value props — latency / performance / scale bottlenecks skew P1 (called out as a primary value proposition).
  5. Security — critical security vulnerabilities / CVEs → P0 (priority/critical-urgent); routine dependency/patch updates → P1 (tied to "Security Fixes" roadmap item).
  6. Low-signal — empty bodies, one-line questions, "collecting use cases", pinned/frozen community threads, items marked triage/not-reproducible/triage/needs-information → P4. Nice-to-have features, refactors, cleanups, test scaffolding → P3.

Procedure

  1. Verify access: gh auth status; confirm repo kubernetes-sigs/agent-sandbox.
  2. Read the roadmap: read roadmap.md; extract themes, item statuses, and any cited issue numbers.
  3. Fetch open issues: gh issue list --repo kubernetes-sigs/agent-sandbox --state open --limit 500 --json number,title,labels,assignees,createdAt,updatedAt,body,url > open_issues.json
  4. Discover board metadata (IDs change per board, always re-fetch):
    • Project + Priority field/options: gh project field-list 120 --owner kubernetes-sigs --format json → grab the Priority field id and the P0–P4 option ids; project id via gh project view 120 --owner kubernetes-sigs --format json.
    • Item ids: gh project item-list 120 --owner kubernetes-sigs --limit 1000 --query "is:open" --format json → map issue number → project item id. Add any open issue not yet on the board with gh project item-add 120 --owner kubernetes-sigs --url <issue-url> --format json.
  5. Triage: assign every open issue exactly one tier using the heuristics. Sanity-check that the assigned set equals the open-issue set (no missing, no extras).
  6. Report first: write a markdown report (issue-triage-report.md) grouping issues by priority with roadmap mapping + one-line rationale, and a "second look" section for judgment calls (e.g., heuristic conflicts, boundary cases, insufficient info, or ambiguous roadmap items). In an interactive run, stop and wait for the user to review before changing anything on GitHub. In an automated/scheduled run, see below.
  7. Apply (after approval in interactive mode, or filtered by untriaged issues in scheduled mode):
    • Label: gh issue edit <#> --repo kubernetes-sigs/agent-sandbox --add-label "<priority/...>" --remove-label "<priority/...>" (if the tier changed).
    • Board field: gh project item-edit --id <itemId> --project-id <projectId> --field-id <fieldId> --single-select-option-id <optionId>.
    • Drive the apply loop from a small script so all issues are processed in one pass (adding a sleep 1 delay between API calls to respect GitHub's 900 points/min secondary rate limit); collect per-issue ok/err and print a final total / errors summary.
  8. Confirm: report the final distribution (count per tier) and any errors.
Show full SKILL.md (209 more words)Show less

Scheduled / automated mode

When invoked non-interactively (e.g. via cron), there is no human to approve the report. In that mode:

  • Still write issue-triage-report.md as an audit artifact.
  • Only apply changes to issues that currently have NO priority/* label (new/untriaged issues), so a daily run is incremental and never silently overrides a human's manual prioritization.
  • For issues that already have a priority label, leave them as-is but list them in the report under "already triaged".
  • Post the run summary (counts applied, counts skipped, errors) as the final message.

Notes

  • Roadmap priority changes are reconciled only via interactive runs, not scheduled mode. When roadmap.md changes the priority of a theme, an interactive run re-triages every open issue against the current roadmap and surfaces the resulting diffs for a human to approve. Scheduled mode deliberately leaves already-triaged issues untouched (see above), so it never silently re-prioritizes existing issues based on a roadmap edit. To propagate a roadmap change to issues that already have a priority/* label, run the skill interactively and apply the proposed changes.
  • All priority/* labels and the P0–P4 options already exist on the repo/board; no need to create them.
  • gh project GraphQL IDs (project, field, options, items) are not stable across boards — always re-discover them at runtime; never hardcode.

© kubernetes-sigs, 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

SKILL.md and 4 other files in .agents/skills/triage-issues of kubernetes-sigs/agent-sandbox.

  • SKILL.md
  • evals/eval_runner.py
  • evals/evals.json
  • evals/files/open_issues.json
  • evals/files/roadmap.md

Open the folder on GitHubat commit cd0761d

Compare with similar skills

Triage Issues 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.

Triage Issues compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Triage Issues this skillkubernetes-sigs/agent-sandbox4.2k—~1.5kAutomated safety check: PassApache-2.0
Devops Pipelineluongnv89/skills131—~4.8kAutomated safety check: PassMIT
Project Referencesaiskillstore/marketplace430—~2.3kAutomated safety check: NotesNone
GitHub Runnermagnus919/agent-skills113—~1.7kAutomated safety check: PassMIT
Tgf Server Devthkhxm/tgf128—~1.3kAutomated safety check: NotesMIT
Ways Of Workingdevantler-tech/ksail165—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Devops Pipeline

    luongnv89/skills

    Configure pre-commit hooks and lean GitHub Actions for shift-left quality assurance.

    131 GitHub stars~4.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Project References

    aiskillstore/marketplace

    Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/.

    430 GitHub stars~2.3k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • GitHub Runner

    magnus919/agent-skills

    Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.

    113 GitHub stars~1.7k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Tgf Server Dev

    thkhxm/tgf

    基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。

    128 GitHub stars~1.3k tokensUpdated 2 mo ago
    DatabasesAuto-check: notes
  • Ways Of Working

    devantler-tech/ksail

    Codifies devantler-tech engineering practices: agent-first development workflow, TDD, CI/CD pipelines, GitHub Flow, code quality gates, and Kubernetes workflows with ksail.

    165 GitHub stars~2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • KubeSphere DevOps Overview

    kubesphere/kubesphere

    Explains the KubeSphere DevOps extension: Jenkins-based CI/CD, ArgoCD GitOps, how DevOps projects map to namespaces, and project naming rules.

    17k GitHub stars~3.1k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed

More from kubernetes-sigs/agent-sandbox

  • Bump Go Version

    kubernetes-sigs/agent-sandbox

    Official

    Bumps the Go version to the latest release across go.mod, tools.mod, and Dockerfiles.

    4.2k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Fix Flakes

    kubernetes-sigs/agent-sandbox

    Official

    Diagnose and fix flaky tests tracked as open kind/flake issues in kubernetes-sigs/agent-sandbox — reproduce the flake, apply a minimal fix, and open a PR linking the issue.

    4.2k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • K8s Agent Sandbox MCP

    kubernetes-sigs/agent-sandbox

    Official

    An MCP server skill for managing Kubernetes sandboxes. An agent skill from kubernetes-sigs/agent-sandbox.

    4.2k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Test Pyramid

    kubernetes-sigs/agent-sandbox

    Official

    Analyze the repo's unit and E2E tests and propose rebalancing toward a test pyramid — which E2E tests (or assertions inside them) can be covered by unit tests, which unit-level gaps genuinely need…

    4.2k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • K8s API Conventions

    kubernetes-sigs/agent-sandbox

    Official

    Guides the agent to follow Kubernetes API conventions for OSS standards.

    4.2k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Dev Rules

    kubernetes-sigs/agent-sandbox

    Official

    Enforces project-specific development rules and conventions.

    4.2k GitHub stars~447 tokensUpdated yesterday
    Auto-check passed

Questions about Triage Issues

What does Triage Issues do?

Triage open GitHub issues for kubernetes-sigs/agent-sandbox by mapping them to roadmap.md and assigning k8s priority labels + Kanban Priority (P0–P4) on Project. Triage Issues is an agent skill from kubernetes-sigs/agent-sandbox, published by the product's own GitHub organization.

When should I use Triage Issues?

Triage Issues fits situations like: tasks that involve Container orchestration; tasks that involve Issue triage; tasks that involve Task management.

How do I install Triage Issues in Claude Code?

Run `npx skills add kubernetes-sigs/agent-sandbox --skill triage-issues -a claude-code`. Or copy the skill folder (.agents/skills/triage-issues in kubernetes-sigs/agent-sandbox) into .claude/skills/triage-issues in your project. Claude Code loads it when a task matches its description.

How do I install Triage Issues in Codex?

Run `npx skills add kubernetes-sigs/agent-sandbox --skill triage-issues -a codex`. Or copy the skill folder (.agents/skills/triage-issues in kubernetes-sigs/agent-sandbox) into .agents/skills/triage-issues in your project. Codex loads it when a task matches its description.

Can I use Triage Issues 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 kubernetes-sigs/agent-sandbox --skill triage-issues -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/triage-issues, .gemini/skills/triage-issues, .github/skills/triage-issues and .opencode/skills/triage-issues in your project.

What does Triage Issues need to run?

Going by SKILL.md and its folder, Triage Issues needs Python for the scripts in its folder and the command-line tools its instructions call (gh). Our summary lists: Python 3.

Does Triage Issues access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Triage Issues 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 Triage Issues use?

Triage Issues is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Triage Issues use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Triage Issues?

Skills that share tags, products or a category with Triage Issues: Devops Pipeline (luongnv89/skills, 131 stars), Project References (aiskillstore/marketplace, 430 stars), GitHub Runner (magnus919/agent-skills, 113 stars) and Tgf Server Dev (thkhxm/tgf, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Triage Issues?

kubernetes-sigs (a GitHub organization, an official publisher) maintains it in kubernetes-sigs/agent-sandbox, which has 4,183 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

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