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

File Issue

by superset-sh in superset-sh/superset

Turn a rough report into a Linear issue someone can pick up — reproduce the claim, check for duplicates, and fill in team, priority, and labels.

Custom licenceAuto-check passedTesting & QA

Install File Issue

skills CLI
$ npx skills add superset-sh/superset --skill file-issue -a claude-code

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

GitHub CLI
$ gh skill install superset-sh/superset file-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/superset-sh/superset.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/linear/skills/file-issue .claude/skills/file-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
file-issue
GitHub stars
15k
Token cost
~920 tokens
SKILL.md length
565 words
Files
1
Skills in repo
47
Repo updated
First seen
Licence
Custom licence

At a glance

Turn a rough report into a Linear issue someone can pick up — reproduce the claim, check for duplicates, and fill in team, priority, and labels.

  • Works in 5 steps: Search before you create → Establish what actually happens → Write the body in the order it gets read → …
  • The user says to file
  • SKILL.md covers 1. Search before you create, 2. Establish what actually…, 3. Write the body in the order… and 4. Route it, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

File Issue is an agent skill from superset-sh/superset. Turn a rough report into a Linear issue someone can pick up — reproduce the claim, check for duplicates, and fill in team, priority, and labels. Use when the user says to file, open, or create an issue, hands over a bug report or error, or asks to get something into Linear.

Its SKILL.md is about 920 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 Testing & QA, covering QA and bug reports. It works with Linear. The repository describes itself as: Superset is an agentic IDE to orchestrate 100+ coding agents in parallel. Run any agent with your own subscription.

When your agent uses it

  • The user says to file
  • Create an issue
  • Hands over a bug report
  • Asks to get something into Linear

Example prompts

  • “/file-issue”

Requirements

  • Pre-approved tools (allowed-tools): mcp__linear__*

Workflow steps

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

  1. Search before you create
  2. Establish what actually happens
  3. Write the body in the order it gets read
  4. Route it
  5. Show it before you create it

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__linear__*

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

File Issue loads about 920 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 565 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 565 words (~920 tokens).

“An issue is a handoff to someone who was not in this conversation. The test is whether they can start without asking you a question.”

— opening of SKILL.md by superset-sh, Custom licence
name
file-issue
allowed-tools
mcp__linear__*
argument-hint
the bug, request, or error to file

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/linear/skills/file-issue of superset-sh/superset.

Open the folder on GitHubat commit 6b94a61

Compare with similar skills

File 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.

File Issue compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
File Issue this skillsuperset-sh/superset15k—~920Automated safety check: PassCustom licence
Mobile QAtloncorp/tlon-apps107—~2.4kAutomated safety check: PassMIT
Write The Docssupabase/supabase111k—~3.9kAutomated safety check: PassApache-2.0
Reproduce Chat Statesdifferent-ai/openwork24k—~673Automated safety check: PassCustom licence
Dynamo Jira TicketDynamoDS/Dynamo2k—~1.1kAutomated safety check: PassApache-2.0
Moav E2EMotherofallVPNs/MoaV449—~1.9kAutomated safety check: NotesMIT

Similar skills

  • Mobile QA

    tloncorp/tlon-apps

    Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.

    107 GitHub stars~2.4k tokensUpdated today
    MobileAuto-check passed

  • Write The Docs

    supabase/supabase

    Official

    Draft new or updated Supabase docs content for a feature or launch, grounded in product intent (Linear when available), a read of the actual code, and the docs style guide.

    111k GitHub stars~3.9k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Reproduce Chat States

    different-ai/openwork

    Fires known chat states in the running OpenWork desktop app, such as provider errors, retries and tool steps, so you can check how each renders.

    24k GitHub stars~673 tokensUpdated today
    Testing & QAAuto-check passed

  • Dynamo Jira Ticket

    DynamoDS/Dynamo

    Create structured Jira tickets for Dynamo from bug reports, failing tests, or feature requests.

    2k GitHub stars~1.1k tokensUpdated yesterday
    Testing & QAAuto-check passed

  • Moav E2E

    MotherofallVPNs/MoaV

    Run and debug MoaV's end-to-end tests — real protocol connectivity (client-test.sh) and the moav CLI smoke test — against a LIVE server, via the self-hosted e2e workflow or a local test VPS.

    449 GitHub stars~1.9k tokensUpdated 3 days ago
    Testing & QAAuto-check: notes

  • Creating A Coral Task

    Human-Agent-Society/CORAL

    Author a new CORAL task — the three pieces that must line up (task.yaml, seed/, a packaged grader/), the coral init → coral validate → smoke-test loop, and how to pick a grader pattern (stdout…

    1.1k GitHub stars~2.2k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

More from superset-sh/superset

All 47 skills in this repo

  • Mobile Demo Film Editor

    superset-sh/superset

    Edits real mobile screen recordings into a configurable demo video with phone framing, title cards, cutaways and an end card, using a bundled renderer.

    15k GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Superset Agent Standup

    superset-sh/superset

    Sweeps every Superset workspace, task and agent terminal to report what finished, what needs review and what is blocked, read-only, and can publish the digest as a page.

    15k GitHub stars~712 tokensUpdated today
    Auto-check passed

  • Superset Browser Control

    superset-sh/superset

    Opens pages, takes screenshots, reads the console, clicks and types in the browser panes of a Superset workspace, with Browser Use as a fallback for other browsers.

    15k GitHub stars~3.1k tokensUpdated today
    Auto-check passed

  • Superset Automate

    superset-sh/superset

    Turns a recurring chore into a scheduled or event-triggered Superset agent, drafting its prompt, picking a target and trigger, and reviewing the first run.

    15k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

  • Drizzle Migration Safety on Neon

    superset-sh/superset

    Generates a Drizzle migration on a fresh Neon branch and runs a production-safety checklist for table sizes, lock order and load rehearsal before the PR opens.

    15k GitHub stars~2k tokensUpdated today
    Auto-check: notes

  • Superset Feedback Reporter

    superset-sh/superset

    Turns a bug report or feature request about Superset into a short, scannable write-up and submits it privately or as a public GitHub issue.

    15k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about File Issue

What does File Issue do?

Turn a rough report into a Linear issue someone can pick up — reproduce the claim, check for duplicates, and fill in team, priority, and labels. File Issue is an agent skill from superset-sh/superset. Turn a rough report into a Linear issue someone can pick up — reproduce the claim, check for duplicates, and fill in team, priority, and labels.

When should I use File Issue?

File Issue fits situations like: the user says to file; create an issue; hands over a bug report; asks to get something into Linear.

How do I install File Issue in Claude Code?

Run `npx skills add superset-sh/superset --skill file-issue -a claude-code`. Or copy the skill folder (plugins/linear/skills/file-issue in superset-sh/superset) into .claude/skills/file-issue in your project. Claude Code loads it when a task matches its description.

How do I install File Issue in Codex?

Run `npx skills add superset-sh/superset --skill file-issue -a codex`. Or copy the skill folder (plugins/linear/skills/file-issue in superset-sh/superset) into .agents/skills/file-issue in your project. Codex loads it when a task matches its description.

Can I use File 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 superset-sh/superset --skill file-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/file-issue, .gemini/skills/file-issue, .github/skills/file-issue and .opencode/skills/file-issue in your project.

What does File Issue need to run?

SKILL.md names no scripts, command-line tools or credentials: File Issue is instructions for the agent only. Its frontmatter pre-approves these tools: mcp__linear__*.

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

File Issue has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does File Issue use?

About 920 tokens (SKILL.md is roughly 3.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 File Issue?

Skills that share tags, products or a category with File Issue: Mobile QA (tloncorp/tlon-apps, 107 stars), Write The Docs (supabase/supabase, 111k stars), Reproduce Chat States (different-ai/openwork, 24k stars) and Dynamo Jira Ticket (DynamoDS/Dynamo, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains File Issue?

superset-sh (a GitHub organization) maintains it in superset-sh/superset, which has 15,063 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 11, 2026.

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