Agent skill

Frb User Question Triage

by vchelaru in vchelaru/FlatRedBall

Answering Discord/GitHub user questions about FlatRedBall — search skills→docs→code, cite the docs URL, propose a doc/API fix with confidence, gate edits on approval.

MITAuto-check passedGame Development

Install Frb User Question Triage

skills CLI
$ npx skills add vchelaru/FlatRedBall --skill frb-user-question-triage -a claude-code

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

GitHub CLI
$ gh skill install vchelaru/FlatRedBall frb-user-question-triage --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/vchelaru/FlatRedBall.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/frb-user-question-triage .claude/skills/frb-user-question-triage && 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
frb-user-question-triage
GitHub stars
578
Token cost
~1.7k tokens
SKILL.md length
879 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Answering Discord/GitHub user questions about FlatRedBall — search skills→docs→code, cite the docs URL, propose a doc/API fix with confidence, gate edits on approval.

  • Works in 4 steps: Classify First → Where to Look: skills orient, docs cite,… → The Four Outcomes → …
  • Tasks that involve Issue triage
  • SKILL.md covers 1. Classify First, 2. Where to Look: skills…, 3. The Four Outcomes and 4. Always Produce, plus 4 more sections
  • Calls gh; reaches docs.flatredball.com

What it does

Frb User Question Triage is an agent skill from vchelaru/FlatRedBall. Answering Discord/GitHub user questions about FlatRedBall — search skills→docs→code, cite the docs URL, propose a doc/API fix with confidence, gate edits on approval. Triggers: pasted user question, "how do I", GitHub issue triage, "answer this person".

Its SKILL.md is about 1.7k 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 Game Development, covering Issue triage. It works with GitHub and Discord. The repository describes itself as: Cross-platform 2D game engine focused on ultimate productivity built in .NET. The licence is MIT.

When your agent uses it

  • Tasks that involve Issue triage

Example prompts

  • “how do I”
  • “answer this person”
  • “/frb-user-question-triage”

Workflow steps

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

  1. Classify First
  2. Where to Look: skills orient, docs cite, code confirms
  3. The Four Outcomes
  4. Always Produce

What it can do on your machine

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

    Hosts in commands or code, which the agent is likely to contact:

    • docs.flatredball.com

    Also links to:

    • discord.gg

    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

Frb User Question Triage loads about 1.7k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 879 words of instructions outside code blocks.

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

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 vchelaru/FlatRedBall at commit fa654ab, republished under its MIT licence (© vchelaru). 879 words, ~1,739 tokens.

Download SKILL.mdSave it as .claude/skills/frb-user-question-triage/SKILL.md (or your agent's skills folder).
name
frb-user-question-triage
description
Answering Discord/GitHub user questions about FlatRedBall — search skills→docs→code, cite the docs URL, propose a doc/API fix with confidence, gate edits on approval. Triggers: pasted user question, "how do I", GitHub issue triage, "answer this person".

Answering User Questions

Use when the user pastes a question from someone (Discord text, a GitHub issue, a #N reference) or asks you to help answer a person. Goal: a short reply they can paste back, grounded in a citable docs URL, plus a fix suggestion when docs or the API fall short.

1. Classify First

  • Usage question ("how do I…", "does FlatRedBall support…", "why does X happen", "where is Y") → this skill handles it.
  • Bug report, feature request, or concrete task → fall through to the normal issue-driven workflow (see CLAUDE.md's "Orchestration preferences" and CLAUDE.local.md). A usage question can still end in an issue — see step 4 — but that's a docs/API gap we surface, not a defect the user reported.

For a GitHub issue, read both gh issue view <num> and gh issue view <num> --comments before deciding — comments often reclassify the ask.

Then decide the surface. Unlike Gum, FRB docs aren't a clean tool-vs-code binary — there are several:

SurfaceDocs pathCovers
Glue / FRB Editorglue-reference/The editor itself — menus, properties, project management, live edit
Engine + Forms codeapi/flatredball/, api/flatredball-forms/Runtime C# APIs
Glue plugin/codegen APIsapi/glue-plugin-api/, api/glue-runtime-api/, api/gluecontrol/Writing Glue plugins, generated-code hooks
Gum integration in FRBgum/Using Gum UI from FRB (adding components to entities/screens, layers) — not Gum's own docs
Other pluginstiled-plugin/, spine/, aseprite/, glue-gluevault-component-pages-animationeditor-plugin/Plugin-specific tool + code usage, mixed
Tutorialstutorials/Walkthroughs (Beefball, Platformer)

Tool cues: "in Glue"/"in the editor", a tab/menu/property name, a screenshot. Code cues: C#, a class/method/namespace name, "in code". Community and docs use "Glue", "FRB Editor", and "FlatRedBall Editor" interchangeably — don't treat them as different things.

  • Obvious which surface → answer for that one only.
  • Not obvious → treat as possibly both editor and code; check both.
  • Investigation is hard or hinges on what they meant → ask the user to clarify before digging deep.

2. Where to Look: skills orient, docs cite, code confirms

  • Skills .claude/skills/ (e.g. gum-integration, glue-live-edit, glue-project-codegen, gum-codegen, gluj-versions, frb-source-linking) orient — point at the right doc page/source file. Never link or paste a skill to a user.
  • Docs — sibling repo ..\FlatRedBallDocs — cite. SUMMARY.md is the index; that's what produces the URL.
  • Code (this repo's engine + FRBDK/Glue) confirms real behavior and locates where a doc should exist or where the API is wrong.

If a skill or code answers the "why" but no doc does, that's a docs-gap signal (outcome C below).

3. The Four Outcomes

FoundOutcome
A. Clear doc answerAnswer the user, prepend the docs URL. Done.
B. Weak doc answer (correct but confusing, buried, missing a gotcha)Answer + propose a doc improvement.
C. Answer only in code, docs missingAnswer from code + propose where in FlatRedBallDocs it should be documented.
D. Code is the problem (confusing/contradictory names, missing or broken feature)Answer honestly + propose an API fix. Most likely to become an issue.
Show full SKILL.md (412 more words)Show less

4. Always Produce

  1. A paste-able reply — a quick message a busy human types in Discord, not a document. Lead with the answer, keep it to a few plain sentences, include the docs URL when one exists. Point to Discord or a GitHub issue only when genuinely useful.
    • Tone: terse and a little lazy, not polished. Failure mode is sounding like AI: no bold, headings, or bullet lists in the reply — plain sentences only. No reassurance filler ("no worries", "great question"). No em dashes — use a comma, parentheses, or two sentences. Keep code formatting (inline code, fenced blocks).
    • Deliver it as a file, not inline — write to a temp .md path and open it (Start-Process <path>) so the user gets clean copy-able source. Keep the terminal response to working notes + a short summary that links the file.
  2. Confidence + justification for any doc/API fix (rubric below).
  3. An issue — only for outcomes C/D, and only after the user agrees. Then gh issue create, per CLAUDE.md's "Orchestration preferences" (issue/branch/PR conventions already documented there — don't duplicate).

Confidence Rubric

  • High — must justify: cite the contradicting doc/code, the broken behavior, or the duplicated/missing content.
  • Medium — plausible improvement, some judgment involved (wording, placement).
  • Low — a hunch worth raising; flag the uncertainty.

Approval Gate

Propose first, act after sign-off. Do not edit FlatRedBallDocs, change code, or run gh issue create until the user agrees.

Building the Docs URL

Don't fetch docs.flatredball.com to look something up or verify a page — the live GitBook site is hard for an agent to navigate reliably (redirects, JS-rendered nav). Read the markdown source directly in the sibling ..\FlatRedBallDocs repo, then construct the citation URL by pattern — no fetch needed to confirm it's right.

Published base: https://docs.flatredball.com/flatredball/. Path mirrors the FlatRedBallDocs repo tree (drop .md):

  • glue-reference/entities/movetolayer.md → https://docs.flatredball.com/flatredball/glue-reference/entities/movetolayer
  • A folder's README.md → the folder path itself: api/README.md → .../flatredball/api
  • Heading anchor = heading lowercased, spaces→-, punctuation stripped.

Landmine: https://docs.flatredball.com/gum/ is a different GitBook space entirely — Gum's own docs (its docs/ folder, in the Gum repo). This repo's own gum/ folder (FRB-side "how to use Gum from FlatRedBall") publishes under .../flatredball/gum/, not .../gum/. Don't cite one when you mean the other — a question about e.g. AttachToContainer or per-Screen Gum wiring belongs to flatredball/gum/; a question about Gum layout/state/binding itself belongs to the separate gum/ space (see [[gum-integration]] for the boundary between the two codebases).

Pointers

  • Gum-in-FRB architecture (plugin structure, .gumx, runtime wrapper) → [[gum-integration]].
  • Issue/branch/worktree/PR flow → CLAUDE.md "Orchestration preferences", CLAUDE.local.md.
  • Domain skills are your first-pass index in step 2 — .claude/skills/.

© vchelaru, 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 .claude/skills/frb-user-question-triage of vchelaru/FlatRedBall.

Open the folder on GitHubat commit fa654ab

Compare with similar skills

Frb User Question Triage 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.

Frb User Question Triage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Frb User Question Triage this skillvchelaru/FlatRedBall578—~1.7kAutomated safety check: PassMIT
Issue Triagemicrosoft/XBOX-Godot-Sample237—~2.5kAutomated safety check: PassMIT
Setup Matt Pocock Skillsbestofjs/bestofjs3.1k20 repos~1.7kAutomated safety check: PassMIT
Windows App SDK Issue Triage Reportmicrosoft/WindowsAppSDK4.7k—~3.4kAutomated safety check: PassApache-2.0
Exposed Bug Fix WorkflowJetBrains/Exposed9.3k—~3.8kAutomated safety check: PassApache-2.0
Pre-Release PR Triagejamiepine/voicebox57k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Issue Triage

    microsoft/XBOX-Godot-Sample

    Official

    First-pass evaluation of a GitHub issue against this repository's code: classify it, find the relevant code, reason about likely causes or fit, flag version differences and missing information, and…

    237 GitHub stars~2.5k tokensUpdated 3 days ago
    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
  • Official

    Generates GitHub Feature Area Status reports for the Windows App SDK repository, scoring issues so teams can see what needs attention in each area.

    4.7k GitHub stars~3.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Exposed Bug Fix Workflow

    JetBrains/Exposed

    Official

    Takes a GitHub or YouTrack issue for the Exposed project through reproduction, a failing test, a fix, validation and a pull request.

    9.3k GitHub stars~3.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • WinAppSDK Triage Meeting Prep

    microsoft/WindowsAppSDK

    Official

    Prepares the triage meeting summary for WinAppSDK Needs-Triage issues, with research-backed area suggestions, draft replies and a diff since the last triage.

    4.7k GitHub stars~2.8k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from vchelaru/FlatRedBall

All 32 skills in this repo
  • Glue Live Game Testing

    vchelaru/FlatRedBall

    Testing GlueControl's embedded runtime (CommandReceiver, GlueControlManager) against a real running game process.

    578 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Glue Unit Test Bootstrap

    vchelaru/FlatRedBall

    Bootstrapping GlueUnitTests that touch GlueState.Self/GlueCommands.Self/ProjectManager.

    578 GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Gluj Versions

    vchelaru/FlatRedBall

    A skill your agent uses when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a…

    578 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Gum Codegen

    vchelaru/FlatRedBall

    A skill your agent uses when working on Glue's Gum code generation — adding/removing/version-gating generated properties on Gum standard runtime types (NineSlice, Text, Container, Sprite, etc.), or…

    578 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Release

    vchelaru/FlatRedBall

    FRB1 (engine + Glue) release runbook — gh CLI sequence for Engine.yml/glue.yml, version scheme, release notes.

    578 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Release Notes

    vchelaru/FlatRedBall

    Drafts FRB1 release notes from commits/PRs since the last release.

    578 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Questions about Frb User Question Triage

What does Frb User Question Triage do?

Answering Discord/GitHub user questions about FlatRedBall — search skills→docs→code, cite the docs URL, propose a doc/API fix with confidence, gate edits on approval. Frb User Question Triage is an agent skill from vchelaru/FlatRedBall. Answering Discord/GitHub user questions about FlatRedBall — search skills→docs→code, cite the docs URL, propose a doc/API fix with confidence, gate edits on approval.

When should I use Frb User Question Triage?

Frb User Question Triage fits situations like: tasks that involve Issue triage.

How do I install Frb User Question Triage in Claude Code?

Run `npx skills add vchelaru/FlatRedBall --skill frb-user-question-triage -a claude-code`. Or copy the skill folder (.claude/skills/frb-user-question-triage in vchelaru/FlatRedBall) into .claude/skills/frb-user-question-triage in your project. Claude Code loads it when a task matches its description.

How do I install Frb User Question Triage in Codex?

Run `npx skills add vchelaru/FlatRedBall --skill frb-user-question-triage -a codex`. Or copy the skill folder (.claude/skills/frb-user-question-triage in vchelaru/FlatRedBall) into .agents/skills/frb-user-question-triage in your project. Codex loads it when a task matches its description.

Can I use Frb User Question Triage 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 vchelaru/FlatRedBall --skill frb-user-question-triage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/frb-user-question-triage, .gemini/skills/frb-user-question-triage, .github/skills/frb-user-question-triage and .opencode/skills/frb-user-question-triage in your project.

What does Frb User Question Triage need to run?

Going by SKILL.md and its folder, Frb User Question Triage needs the command-line tools its instructions call (gh).

Does Frb User Question Triage access the network?

SKILL.md names 2 domains. In commands or code: docs.flatredball.com; the agent is likely to contact it when it follows the instructions. As links in the text: discord.gg. This is read from the text; nothing was executed.

Is Frb User Question Triage 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 Frb User Question Triage use?

Frb User Question Triage 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 Frb User Question Triage use?

About 1.7k tokens (SKILL.md is roughly 7k 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 Frb User Question Triage?

Skills that share tags, products or a category with Frb User Question Triage: Issue Triage (microsoft/XBOX-Godot-Sample, 237 stars), Setup Matt Pocock Skills (bestofjs/bestofjs, 3.1k stars), Windows App SDK Issue Triage Report (microsoft/WindowsAppSDK, 4.7k stars) and Exposed Bug Fix Workflow (JetBrains/Exposed, 9.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Frb User Question Triage?

vchelaru (a GitHub user) maintains it in vchelaru/FlatRedBall, which has 578 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 10, 2026.

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