Agent skill

Linear Ticket SOP

by bybren-llc in bybren-llc/safe-agentic-workflow

“Ticket management best practices for Linear or equivalent project tracker. Use when creating issues, updating ticket status, attaching evidence, parsing acceptance criteria, or…”

— description from SKILL.md by bybren-llc
MITAuto-check passedProduct & Project Management

Install Linear Ticket SOP

skills CLI
$ npx skills add bybren-llc/safe-agentic-workflow --skill linear-sop -a claude-code

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

GitHub CLI
$ gh skill install bybren-llc/safe-agentic-workflow linear-sop --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/bybren-llc/safe-agentic-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/linear-sop .claude/skills/linear-sop && 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
linear-sop
GitHub stars
423
Token cost
~1.8k tokens
SKILL.md length
459 words
Files
4 (incl. scripts, references, assets)
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Purpose, When This Skill Applies, Ticket System Operations and Program Structure, plus 7 more sections
  • Reaches github.com

About this skill

“Ticket management best practices for Linear or equivalent project tracker. Use when creating issues, updating ticket status, attaching evidence, parsing acceptance criteria, or working with ticket UUIDs. Provides evidence templates for dev/staging/done phases.”

— description from SKILL.md by bybren-llc

Linear Ticket SOP is a skill in bybren-llc/safe-agentic-workflow (423 stars). Its SKILL.md is about 1.8k tokens, with 3 other files in the folder (scripts, references, assets). Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit 26ca58b. 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 1 file in scripts/, which the agent can run.

    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:

    • 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

Linear Ticket SOP loads about 1.8k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 459 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from bybren-llc/safe-agentic-workflow at commit 26ca58b, republished under its MIT licence (© bybren-llc). 459 words, ~1,763 tokens.

Download SKILL.mdSave it as .claude/skills/linear-sop/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
linear-sop
description
Ticket management best practices for Linear or equivalent project tracker. Use when creating issues, updating ticket status, attaching evidence, parsing acceptance criteria, or working with ticket UUIDs. Provides evidence templates for dev/staging/done phases.

Linear SOP Skill

TEMPLATE: This skill uses {{PLACEHOLDER}} tokens. Replace with your project values before use.

Purpose

Guide consistent ticket management. Provides evidence templates for the mandatory dev/staging/UAT evidence policy.

When This Skill Applies

  • Creating new issues in the ticket system
  • Updating ticket status
  • Attaching evidence to tickets
  • Parsing acceptance criteria
  • Working with UUIDs and issue IDs

Ticket System Operations

Reading Issues
text
# Get issue by identifier
get_issue({ id: "{{TICKET_PREFIX}}-459" })

# List issues with filters
list_issues({
  team: "{{PROJECT_TEAM_NAME}}",
  state: "In Progress",
  assignee: "me",
})
Creating Issues
text
create_issue({
  title: "feat(scope): description",
  team: "{{PROJECT_TEAM_NAME}}",
  description: "## Summary\n\n...",
  labels: ["feature", "sprint-1"],
  parentId: "parent-uuid",  // Optional - for sub-issues
})
Updating Issues
text
update_issue({
  id: "{{TICKET_PREFIX}}-459",
  state: "Done",
})
Adding Comments
text
create_comment({
  issueId: "{{TICKET_PREFIX}}-459",
  body: "**Dev Evidence**\n\n...",
})

Program Structure

For work that spans many issues, most trackers have objects above the issue. Use them; do not flatten a program into a flat list of tickets.

The Hierarchy
text
Initiative          the program (one per program)
  └── Project       a Unit of Work — one coherent outcome
       ├── Milestone    an AI-DLC phase: Inception, Construction, Operations
       └── Issue        a Story
            └── Sub-issue   a Mob Elaboration task (created during Inception, not before)
Prerequisite: labels must already exist

Program build-out assumes these label namespaces are pre-created in the workspace. Create them before building the program, not during:

  • bolt:0 … bolt:N — which Bolt an issue belongs to
  • agent:* — the lead role (must match an actual agent role defined for the project)

Where the tracker scopes labels globally, do not create per-team duplicates.

Streams

Some trackers gate sub-initiatives behind a paid tier. Where sub-initiatives are available, model program streams as sub-initiatives under the initiative. Where they are not, encode the stream as project priority instead — highest-risk stream gets Urgent/High, follow-up stream gets Medium. Both are valid; pick based on what your tracker supports.

Dependency Wiring

Build the dependency DAG with issue relations:

text
update_issue({
  id: "{{TICKET_PREFIX}}-XXX",
  blocks: ["{{TICKET_PREFIX}}-YYY"],       // this issue must land first
  blockedBy: ["{{TICKET_PREFIX}}-ZZZ"],    // this issue waits on that one
})

Use relatedTo for soft links that inform but do not block.

Wire so the enforcement lands before the thing it enforces — see the safe-ai-dlc skill for the four dependency-wiring heuristics.

Re-parenting existing issues

When a program absorbs tickets that already exist, update them into the project — never recreate them. Duplicates break traceability and split the evidence trail.

Show full SKILL.md (188 more words)Show less

Evidence Policy (MUST)

Every issue requires evidence at each phase:

PhaseRequired?Content
DevMUSTImplementation proof
StagingMUSTUAT validation (or N/A)
DoneMUSTFinal verification

Evidence Templates

Dev Evidence Template
markdown
**Dev Evidence**

**PR**: https://github.com/{{ORG_NAME}}/{{REPO_NAME}}/pull/XXX
**Commit**: [short-hash]
**Branch**: {{TICKET_PREFIX}}-XXX-description

**Implementation:**
- [x] Feature implemented
- [x] Tests passing
- [x] Lint passing

**Verification:**
{{CI_VALIDATE_COMMAND}}
# Output: All checks passed
Staging/UAT Evidence Template
markdown
**Staging Evidence**

**Environment**: {{STAGING_ENV_NAME}}
**URL**: {{STAGING_URL}}

**Validation Steps:**
1. Deployed to staging: [timestamp]
2. Smoke test passed: [yes/no]
3. Feature verified: [description]

**UAT Status:** [Passed/Pending/N/A]

If N/A, reason: [e.g., "Dev tooling only - no user-facing changes"]
Done Evidence Template
markdown
**Done Evidence**

**PR Merged**: https://github.com/{{ORG_NAME}}/{{REPO_NAME}}/pull/XXX
**Merge Commit**: [hash]

**Final Checklist:**
- [x] All acceptance criteria met
- [x] Documentation updated (if applicable)
- [x] No regressions detected

Acceptance Criteria Parsing

When reading issue descriptions, extract ACs:

markdown
## Acceptance Criteria
- [ ] User can perform action X
- [ ] System responds with Y
- [ ] Error handling for Z

Convert to testable checklist for verification.

Status Workflow

text
Backlog -> Ready -> In Progress -> Testing -> Ready for Review -> Done
GitHub-Linear Auto-Sync

Tickets referenced in commit messages (e.g., [{{TICKET_PREFIX}}-123]) automatically move to Done when the PR merges. Child stories not referenced in any commit message must be manually closed after merge.

Best practice: Reference Feature-level tickets in commit messages. After merge, manually close orphaned child stories that were not referenced.

Status Update Guidelines
FromToWhen
BacklogReadySprint planning
ReadyIn ProgressWork starts
In ProgressTestingPR created
TestingReady for ReviewTests pass, UAT complete
Ready for ReviewDonePOPM approval or auto-sync via PR

UUID Handling

Most ticket systems use UUIDs internally. When working with APIs:

text
// Issue identifiers (human-readable)
const issueId = "{{TICKET_PREFIX}}-459";

// UUIDs (API operations)
const uuid = "ef6a5fa0-2b46-417f-8266-dea2d187b10a";

// Get UUID from identifier via API
// Returns issue object with .id property containing UUID

Common Operations

PRs are automatically linked when:

  • Branch name contains {{TICKET_PREFIX}}-XXX
  • PR title contains [{{TICKET_PREFIX}}-XXX]
Create Sub-Issue
text
create_issue({
  title: "Sub-task description",
  team: "{{PROJECT_TEAM_NAME}}",
  parentId: "parent-issue-uuid",
})
Query by Label
text
list_issues({
  label: "sprint-1",
  team: "{{PROJECT_TEAM_NAME}}",
})

Authoritative References

  • Agent Workflow SOP: docs/sop/AGENT_WORKFLOW_SOP.md
  • CONTRIBUTING.md: Workflow documentation

© bybren-llc, MIT. 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 3 other files (scripts, references, assets) in .agents/skills/linear-sop of bybren-llc/safe-agentic-workflow.

  • SKILL.md
  • assets/.gitkeep
  • references/.gitkeep
  • scripts/.gitkeep

Open the folder on GitHubat commit 26ca58b

Compare with similar skills

Linear Ticket SOP 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.

Linear Ticket SOP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear Ticket SOP this skillbybren-llc/safe-agentic-workflow423—~1.8kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Jira Natural Language Interfacejjmartres/opencode1333 repos~1.7kAutomated safety check: PassMIT
Project Planneradrianpuiu/claude-skills-marketplace1001 repos~6kAutomated safety check: PassNone
Milestone Project Managerfinna/project-manager-skill136—~4.3kAutomated safety check: PassNone
Active Plan Auditwithkynam/vibecode-pro-max-kit1.1k—~757Automated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Lets an agent view, create, update and transition Jira issues in natural language, automatically choosing between the jira CLI and Atlassian MCP tools.

    133 GitHub starsUsed in 3 repos~1.7k tokens
    Product & Project ManagementAuto-check passed
  • Project Planner

    adrianpuiu/claude-skills-marketplace

    Comprehensive project planning and documentation generator for software projects.

    100 GitHub starsUsed in 1 repo~6k tokens
    Product & Project ManagementAuto-check passed
  • Milestone Project Manager

    finna/project-manager-skill

    Drives an authorized software, app or game project to completion through small milestones, an existing implementation thread, independent testing of the exact build and retest loops.

    136 GitHub stars~4.3k tokensUpdated 9 days ago
    Product & Project ManagementAuto-check passed
  • Active Plan Audit

    withkynam/vibecode-pro-max-kit

    Reviews a codebase's active plan files for staleness and completion, then archives only the ones confirmed done or obsolete against the real code.

    1.1k GitHub stars~757 tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed
  • Gsd Plant Seed

    SpillwaveSolutions/agent-brain

    Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone

    119 GitHub starsUsed in 2 repos~691 tokens
    Product & Project ManagementAuto-check passed

More from bybren-llc/safe-agentic-workflow

All 42 skills in this repo
  • Multi-Agent Coordination Template

    bybren-llc/safe-agentic-workflow

    Agent assignment matrix, blocker escalation, and TDM coordination patterns. Use when assigning work to specialist agents, managing blockers across agents…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • API Route Patterns

    bybren-llc/safe-agentic-workflow

    API route implementation patterns with RLS, validation, and error handling. Use when creating API routes, implementing CRUD endpoints, adding server-side…

    423 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Technical Documentation Templates

    bybren-llc/safe-agentic-workflow

    Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Deployment SOP Checklist

    bybren-llc/safe-agentic-workflow

    Deployment workflows, pre-deploy validation, smoke testing, and rollback procedures. Use when deploying to staging or production, running smoke tests…

    423 GitHub stars~950 tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend Patterns Template

    bybren-llc/safe-agentic-workflow

    Frontend patterns for modern web frameworks, component libraries, auth flows, and analytics. Use when building UI components, creating pages, implementing…

    423 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Advanced Git Operations

    bybren-llc/safe-agentic-workflow

    Advanced git operations including rebase, bisect, cherry-pick, and conflict resolution. Use when rebasing feature branches, debugging with bisect…

    423 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Linear Ticket SOP

How do I install Linear Ticket SOP in Claude Code?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill linear-sop -a claude-code`. Or copy the skill folder (.agents/skills/linear-sop in bybren-llc/safe-agentic-workflow) into .claude/skills/linear-sop in your project. Claude Code loads it when a task matches its description.

How do I install Linear Ticket SOP in Codex?

Run `npx skills add bybren-llc/safe-agentic-workflow --skill linear-sop -a codex`. Or copy the skill folder (.agents/skills/linear-sop in bybren-llc/safe-agentic-workflow) into .agents/skills/linear-sop in your project. Codex loads it when a task matches its description.

Can I use Linear Ticket SOP 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 bybren-llc/safe-agentic-workflow --skill linear-sop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linear-sop, .gemini/skills/linear-sop, .github/skills/linear-sop and .opencode/skills/linear-sop in your project.

What does Linear Ticket SOP need to run?

SKILL.md names no scripts, command-line tools or credentials: Linear Ticket SOP is instructions for the agent only.

Does Linear Ticket SOP access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Linear Ticket SOP 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linear Ticket SOP use?

Linear Ticket SOP 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 Linear Ticket SOP use?

About 1.8k tokens (SKILL.md is roughly 7.1k 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 Linear Ticket SOP?

Skills that share tags, products or a category with Linear Ticket SOP: CCPM Project Management (automazeio/ccpm, 8.4k stars), Jira Natural Language Interface (jjmartres/opencode, 133 stars), Project Planner (adrianpuiu/claude-skills-marketplace, 100 stars) and Milestone Project Manager (finna/project-manager-skill, 136 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear Ticket SOP?

bybren-llc (a GitHub organization) maintains it in bybren-llc/safe-agentic-workflow, which has 423 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on July 20, 2026.

Source: bybren-llc/safe-agentic-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.