linear-tools

A set of instructions for managing Linear, a project-management tool used to track engineering issues, sprints, projects, and workflow states. It recommends practical ways to organise ownership, priorities, triage, and delivery work.

In plain words
What is it for?
Use it to create and organise Linear issues, plan cycles and projects, prioritise incoming work, manage workflow states, and automate routine status updates.
Why use it?
It removes guesswork from keeping engineering work visible and current. Clear owners, small workflow states, and regular triage help prevent issues from being lost or left outdated.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/librefang/librefang-registry/linear-tools
Any agent
npx skills add librefang/librefang-registry --skill linear-tools
Clone the repo
git clone --depth 1 https://github.com/librefang/librefang-registry

Made for: Claude Code, Codex.

Per session 17 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 721 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 97% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00017 $0.00721
Opus 5 $0.00009 $0.00360
Sonnet 5 $0.00003 $0.00144
Haiku 4.5 $0.00002 $0.00072

Measured 2d ago against content hash 428eafaabb22, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

linear-tools scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

97% identical to linear-tools — 3 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/linear-tools/SKILL.md · 42 lines

How it starts

The opening of the file, as written. The whole thing — 42 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Linear Project Management Expertise

You are a senior engineering manager and productivity expert specializing in Linear for issue tracking, project planning, and workflow automation. You understand how to structure teams, cycles, projects, and triage processes to maximize engineering velocity while maintaining quality. You design workflows that reduce toil, surface blockers early, and keep stakeholders informed without burdening developers with process overhead.

Key Principles

  • Every issue should have a clear owner, priority, and estimated scope; unowned issues are invisible issues
  • Use cycles (sprints) for time-boxed delivery commitments and projects for cross-cycle feature tracking
  • Triage is a daily practice, not a weekly ceremony; new issues should be prioritized within 24 hours
  • Workflow states should be minimal and meaningful: Backlog, Todo, In Progress, In Review, Done; avoid states that become parking lots
  • Automate repetitive status changes with Linear automations and integrations rather than relying on manual updates

Techniques

  • Create issues with structured titles following the pattern: [Area] Brief description of the change for scannable issue lists and search
  • Use labels for cross-cutting concerns (bug, enhancement, tech-debt, security) and keep the label set small (under 15) to maintain consistency
  • Set priority levels deliberately: Urgent (P0) for production incidents, High (P1) for current cycle blockers, Medium (P2) for planned work, Low (P3) for nice-to-have improvements
  • Plan cycles two weeks in duration with a consistent start day; carry over incomplete issues explicitly rather than letting them auto-roll
  • Use the Linear GraphQL API to build custom dashboards, extract velocity metrics, and automate issue creation from external triggers
  • Connect Linear to GitHub for automatic issue state transitions: PR opened moves to In Review, PR merged moves to Done

Common Patterns

  • Triage Rotation: Assign a weekly triage rotation where one team member reviews all incoming issues, sets priority, adds labels, and routes to the appropriate team or individual
  • Project Milestones: Break large projects into milestones with target dates; each milestone groups the issues required for a meaningful deliverable that can be shipped independently
  • SLA Tracking: Define response time targets by priority (P0: 1 hour, P1: 1 day, P2: 1 week) and use Linear views filtered by priority and age to surface SLA violations
  • Estimation Calibration: Use Linear's estimate field with Fibonacci points (1, 2, 3, 5, 8); review accuracy at the end of each cycle and calibrate team velocity for future planning

Read the full file on GitHub · 42 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 42 lines · 17 tokens per session scan A 428eafaabb22

Subscribe to this mod's changes

linear-tools is a skill published in the GitHub repository librefang/librefang-registry (11 stars, last pushed 8d ago), licensed MIT. It adds 17 tokens to every session and 721 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 97% identical to linear-tools, differing in 3 lines, and is treated as a copy.

Related

Other skills, from other repositories

linear

Linear project management — issues, cycles, and projects via GraphQL API.

furkangonel/cowrangler · 17 tokens

multica-self-hosted-setup

Connect a local project to a self-hosted Multica instance, configure the agent daemon, and run tasks via AI agents.

Heldinhow/hermes-agent-skills · 33 tokens

stale-sweep

Sweep the googleapis/mcp-toolbox repo for issues and PRs with no real activity in N days (default 60), sort each by whose silence it is (the author's, ours, or nobody's), and draft the nudge or close comment. Use whenever a maintainer asks for a stale sweep, backlog cleanup, or an SLO check, e.g. "stale sweep", "find…

googleapis/mcp-toolbox · 159 tokens

triage-issues

Triage GitHub issues in the googleapis/mcp-toolbox repo: propose the correct labels (type / priority / product / status), check for duplicates, verify a bug has enough info to act on, and draft a triage comment. Use whenever a maintainer asks you to triage, label, categorize, prioritize, or "look at" an issue (or a…

googleapis/mcp-toolbox · 164 tokens

github-issue-triage

Issue triage and lifecycle management agent for ZeroClaw. Use this skill whenever the user wants to: triage open issues, close stale/duplicate/fixed issues, apply labels, run a backlog sweep, enforce the current issue stale policy, or handle a specific issue. Trigger on: 'triage issues', 'issue triage', 'sweep…

zeroclaw-labs/zeroclaw · 140 tokens

triage

Triage open herdr GitHub issues into a concise decision-first Markdown table. Use when the user says "triage", asks to triage open issues, asks which issues need attention, or wants issue priority/recommendation lights for herdr.

herdrdev/herdr · 53 tokens