linear-discipline
Always-on Linear session discipline and one-time soft nudge for untracked repos. Use whenever non-trivial work is happening in a repo that already has a Linear tracking protocol in CLAUDE.md, AGENTS.md, or .cursor/rules; or when opening/working in a repo with no protocol and no .linear-tracking-skip file (ask once to run linear-setup). Enforces search-before-create, lifecycle, and close-the-loop. NOT for full bootstrap, sync, or monitor runs.
How do I install this agent skill?
npx skills add https://github.com/tjcages/linear --skill linear-disciplineIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a comprehensive framework for an AI agent to maintain project tracking discipline using Linear. It includes robust instructions for authentication, methodology for project organization, and explicit safety guardrails for handling untrusted repository data. No security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Linear discipline (always-on)
Chat rules: RESPONSE.md. Auth before Linear calls: AUTH.md.
Detect tracking
Tracked if the repo has a “Linear tracking” (or equivalent) section in CLAUDE.md, AGENTS.md, or .cursor/rules/* that names team + project.
Skipped if .linear-tracking-skip exists at repo root.
If tracked
Follow the protocol written in-repo:
- Search before create.
- Non-trivial work → file/update an issue in the named project + milestone.
Backlog→In Progressat start →Doneonly when shipped.- Close the loop before session end (state and/or comment).
- Prefer Linear’s generated branch names.
Before any Linear tool call: Step 0 auth.
If untracked and not skipped (soft nudge — 1B)
Ask once, one line, no preamble:
This repo isn’t tracked in Linear. Set it up now? (~10–20 min)
- Yes → hand off to
linear-setup(do not bootstrap inline without that skill’s gates). - No → create
.linear-tracking-skipat repo root; stay quiet next time. - Never auto-create Linear projects or issues from a nudge alone.
- Never nudge from Automation /
linear-monitorruns.
If skipped
Stay quiet about setup. Still use Linear MCP for explicit user requests.
Out of scope
Full bootstrap → linear-setup. Rescue/audit → linear-sync. Health digest → linear-monitor.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tjcages/linear/linear-discipline">View linear-discipline on skillZs</a>