Agent skill

Link Ticket To Session

by JayantDevkar in JayantDevkar/claude-code-karma

Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma.

Apache-2.0Auto-check: notesDevelopment

Install Link Ticket To Session

skills CLI
$ npx skills add JayantDevkar/claude-code-karma --skill link-ticket-to-session -a claude-code

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

GitHub CLI
$ gh skill install JayantDevkar/claude-code-karma link-ticket-to-session --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/JayantDevkar/claude-code-karma.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/link-ticket-to-session .claude/skills/link-ticket-to-session && 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
link-ticket-to-session
GitHub stars
329
Token cost
~1.8k tokens
SKILL.md length
721 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma.

  • Works in 6 steps: Parse $ARGUMENTS → Identify provider and (for GitHub) kind → Fetch metadata via MCP (when available) → …
  • The user explicitly asks to link
  • SKILL.md covers Step 1 — Parse $ARGUMENTS, Step 2 — Identify provider and…, Step 3 — Fetch metadata via… and Step 4 — POST the link, plus 3 more sections
  • Calls curl; reaches linear.app and github.com

What it does

Link Ticket To Session is an agent skill from JayantDevkar/claude-code-karma. Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma. Use when the user explicitly asks to link, attach, associate, or connect this session to a ticket, issue, or PR — e.g. "/link-ticket-to-session ABC-123", "link this session to LINEAR-42", "associate this work with issue

Its SKILL.md is about 1.8k 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 Development, covering Pull requests. It works with GitHub, Jira and Model Context Protocol. The repository describes itself as: Dashboard for monitoring claude code sessions. The licence is Apache-2.0.

When your agent uses it

  • The user explicitly asks to link
  • Connect this session to a ticket

Example prompts

  • “/link-ticket-to-session ABC-123”
  • “link this session to LINEAR-42”
  • “/link-ticket-to-session”

Requirements

  • Pre-approved tools (allowed-tools): Bash, mcp__linear, mcp__claude_ai_Linear, mcp__plugin_github_github, mcp__atlassian

Workflow steps

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

  1. Parse $ARGUMENTS
  2. Identify provider and (for GitHub) kind
  3. Fetch metadata via MCP (when available)
  4. POST the link
  5. PUT the metadata (only if Step 3 succeeded)
  6. Confirm to the user

What it can do on your machine

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

    • Bash
    • mcp__linear
    • mcp__claude_ai_Linear
    • mcp__plugin_github_github
    • mcp__atlassian

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    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:

    • linear.app
    • github.com
    • acme.atlassian.net

    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

Link Ticket To Session loads about 1.8k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 721 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, mcp__linear, mcp__claude_ai_Linear, mcp__plugin_github_github, mcp__atlassian

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 JayantDevkar/claude-code-karma at commit 98442cd, republished under its Apache-2.0 licence (© JayantDevkar). 721 words, ~1,804 tokens.

Download SKILL.mdSave it as .claude/skills/link-ticket-to-session/SKILL.md (or your agent's skills folder).
name
link-ticket-to-session
description
Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma. Use when the user explicitly asks to link, attach, associate, or connect this session to a ticket, issue, or PR — e.g. "/link-ticket-to-session ABC-123", "link this session to LINEAR-42", "associate this work with issue
allowed-tools
Bash, mcp__linear, mcp__claude_ai_Linear, mcp__plugin_github_github, mcp__atlassian
argument-hint
<ticket-ref-or-url>

You are linking the current Claude Code session (${CLAUDE_SESSION_ID}) to: $ARGUMENTS

Karma is a read-only observer on the user's machine. It stores the link and caches title/status for display, but never writes back to the ticket provider. You fetch metadata via the user's already-configured MCP server.

Karma's API URL comes from KARMA_API_URL (set by users on non-default ports/hosts) with http://localhost:8020 as fallback. Inline ${KARMA_API_URL:-http://localhost:8020} in every curl below — bash variables don't persist across separate Bash tool calls, so a top-of-script assignment would be empty by the time the next curl runs.

Step 1 — Parse $ARGUMENTS

Recognized forms:

ProviderShort refURL forms
LinearLINEAR-123https://linear.app/.../issue/ABC-123
JiraPROJ-45https://*.atlassian.net/browse/PROJ-45
GitHub Issueowner/repo#42https://github.com/owner/repo/issues/42
GitHub PRowner/repo#42https://github.com/owner/repo/pull/42

GitHub issues and pull requests share a single numbering namespace — owner/repo#42 could be either. The URL kind (/issues/ vs /pull/) is the only signal, and karma's backend preserves it, so when you have a URL keep it intact when POSTing (Step 4). For a bare owner/repo#N with no URL, default to /issues/N — GitHub auto-redirects to /pull/N when N is actually a PR, so the link still resolves.

A bare #N (no owner/repo) is not accepted — always qualify with owner/repo#N.

Step 2 — Identify provider and (for GitHub) kind

Set two variables you'll use below:

  • <provider> ∈ linear | jira | github
  • For GitHub: <kind> ∈ issue | pull_request (derived from URL path)

For Linear and Jira this collapses to just <provider>.

Step 3 — Fetch metadata via MCP (when available)

Pick the right MCP tool for the provider and kind:

Provider · KindMCP tool
linearLinear MCP — search/fetch issue by key
jiraAtlassian MCP — fetch by key
github · issuemcp__plugin_github_github__issue_read, method get
github · pull_requestmcp__plugin_github_github__pull_request_read, method get

Calling the wrong GitHub method silently returns the wrong thing because both shapes look superficially similar — so derive the kind first.

If the relevant MCP isn't installed, skip this step and proceed to Step 4 without title/status. Karma will create the link; the title/status fields stay NULL and can be refreshed later via Step 5.

Pull at minimum: title, status (or state), url. Strip large fields — karma caps metadata_json at 64 KB and a full PR payload easily exceeds that. Specifically drop:

  • GitHub PR: body, commits, files, reviewers, comments, labels, requested_reviewers, head / base blobs beyond ref
  • GitHub issue: body, comments, reactions, labels
  • Linear / Jira: description, comments, subscribers, attachments
Status semantics by kind

The status you cache should reflect what the provider says now, not a generic "open/closed". Karma's UI normalizes these to canonical buckets at render time, so faithful provider language is the right input:

  • Linear: workflow state name verbatim — e.g. Backlog, In Progress, In Review, Done, Cancelled (workspace-defined; don't normalize).

  • Jira: workflow state name — e.g. To Do, In Progress, In Review, Done.

  • GitHub issue: open or closed.

  • GitHub PR: derive from the flags the PR API returns:

    statedraftmergedCache as
    opentrue—draft
    openfalse—open
    closed—trueMERGED
    closed—falseclosed
Show full SKILL.md (240 more words)Show less

Step 4 — POST the link

The url field should be the URL you actually have — /pull/N for PRs, /issues/N for issues. Don't rewrite it. Karma's parser preserves the path segment; the UI uses it to distinguish PRs from issues.

bash
curl -s -X POST "${KARMA_API_URL:-http://localhost:8020}/sessions/${CLAUDE_SESSION_ID}/tickets" \
     -H 'Content-Type: application/json' \
     -d '{"ref":"<key>","provider":"<provider>","url":"<url>","source":"slash_command"}'

For GitHub, <key> is always owner/repo#N regardless of kind — the URL field carries the issue/PR distinction.

Step 5 — PUT the metadata (only if Step 3 succeeded)

bash
curl -s -X PUT "${KARMA_API_URL:-http://localhost:8020}/tickets/<provider>/<key>" \
     -H 'Content-Type: application/json' \
     -d '{"title":"<title>","status":"<status>"}'

For GitHub keys with / and #, URL-encode the key in the path: octocat/repo#42 → octocat%2Frepo%2342.

Step 6 — Confirm to the user

One line. For GitHub, distinguish the kind so the user knows what they just attached:

  • Linked session to LINEAR-123 (Fix login bug, In Progress) — open at https://linear.app/...
  • Linked session to PROJ-45 (Migrate auth, Done) — open at https://acme.atlassian.net/browse/PROJ-45
  • Linked session to octocat/repo#42 [issue] (Empty state lies, open) — open at .../issues/42
  • Linked session to octocat/repo#42 [PR] (Fix linting, MERGED) — open at .../pull/42

Notes

  • Karma is loopback-only by default. KARMA_API_URL overrides for custom port or remote host.
  • POST is idempotent on (session, ticket); re-running upgrades the link_source if previously set by branch-detect or dashboard. Order: slash_command > dashboard > branch.
  • If the API is unreachable, tell the user karma not running at ${KARMA_API_URL:-http://localhost:8020} so they see what was tried. Don't silently succeed.
  • GitHub issues and PRs sharing #N means a single karma row (one (provider, external_key) pair) covers both views of that number. The URL field is what tells karma's UI which one to render. Send the URL you actually have.

© JayantDevkar, Apache-2.0. 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 skills/link-ticket-to-session of JayantDevkar/claude-code-karma.

Open the folder on GitHubat commit 98442cd

Compare with similar skills

Link Ticket To Session 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.

Link Ticket To Session compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Link Ticket To Session this skillJayantDevkar/claude-code-karma329—~1.8kAutomated safety check: NotesApache-2.0
Review Release Noteschef/chef-web-docs143—~5.2kAutomated safety check: PassCustom licence
Plane Release Notes Generatormakeplane/plane60k—~2.5kAutomated safety check: PassAGPL-3.0
Mariadb Operator PR Reviewmariadb-operator/mariadb-operator1k—~3.3kAutomated safety check: PassApache-2.0
Code Reviewnteract/semiotic2.7k—~1.5kAutomated safety check: PassApache-2.0
Issue Triage Loopcobusgreyling/loop-engineering11k—~522Automated safety check: PassMIT

Similar skills

  • Review Release Notes

    chef/chef-web-docs

    Read a release notes file and edit it using Jira release data and GitHub pull requests as co-equal, optional sources.

    143 GitHub stars~5.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Builds categorized release notes for a Plane release pull request from its commits and writes them into the PR description, for both the plane-cloud and plane-ee repos.

    60k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Mariadb Operator PR Review

    mariadb-operator/mariadb-operator

    Perform a structured maintainer-style PR review for the mariadb-operator repository.

    1k GitHub stars~3.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Code Review

    nteract/semiotic

    Review Semiotic pull requests for behavioral bugs, regressions, contract drift, and missing evidence.

    2.7k GitHub stars~1.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Issue Triage Loop

    cobusgreyling/loop-engineering

    Scans open GitHub issues and discussions, flags duplicates, scores priority and proposes labels into issue-triage-state.md without ever labeling or closing.

    11k GitHub stars~522 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Dynamo PR Description

    DynamoDS/Dynamo

    Generate PR descriptions for Dynamo that align with the team template section names and order.

    2k GitHub stars~880 tokensUpdated today
    DevelopmentAuto-check passed

Categories

Questions about Link Ticket To Session

What does Link Ticket To Session do?

Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma. Link Ticket To Session is an agent skill from JayantDevkar/claude-code-karma. Link the current Claude Code session to a ticket (Linear, Jira, GitHub Issues, or GitHub Pull Requests) and cache its title/status in karma.

When should I use Link Ticket To Session?

Link Ticket To Session fits situations like: the user explicitly asks to link; connect this session to a ticket.

How do I install Link Ticket To Session in Claude Code?

Run `npx skills add JayantDevkar/claude-code-karma --skill link-ticket-to-session -a claude-code`. Or copy the skill folder (skills/link-ticket-to-session in JayantDevkar/claude-code-karma) into .claude/skills/link-ticket-to-session in your project. Claude Code loads it when a task matches its description.

How do I install Link Ticket To Session in Codex?

Run `npx skills add JayantDevkar/claude-code-karma --skill link-ticket-to-session -a codex`. Or copy the skill folder (skills/link-ticket-to-session in JayantDevkar/claude-code-karma) into .agents/skills/link-ticket-to-session in your project. Codex loads it when a task matches its description.

Can I use Link Ticket To Session 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 JayantDevkar/claude-code-karma --skill link-ticket-to-session -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/link-ticket-to-session, .gemini/skills/link-ticket-to-session, .github/skills/link-ticket-to-session and .opencode/skills/link-ticket-to-session in your project.

What does Link Ticket To Session need to run?

Going by SKILL.md and its folder, Link Ticket To Session needs the command-line tools its instructions call (curl). Its frontmatter pre-approves these tools: Bash, mcp__linear, mcp__claude_ai_Linear, mcp__plugin_github_github, mcp__atlassian.

Does Link Ticket To Session access the network?

SKILL.md names 3 domains. In commands or code: linear.app, github.com and acme.atlassian.net; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Link Ticket To Session safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Link Ticket To Session use?

Link Ticket To Session is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Link Ticket To Session use?

About 1.8k tokens (SKILL.md is roughly 7.2k 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 Link Ticket To Session?

Skills that share tags, products or a category with Link Ticket To Session: Review Release Notes (chef/chef-web-docs, 143 stars), Plane Release Notes Generator (makeplane/plane, 60k stars), Mariadb Operator PR Review (mariadb-operator/mariadb-operator, 1k stars) and Code Review (nteract/semiotic, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Link Ticket To Session?

JayantDevkar (a GitHub user) maintains it in JayantDevkar/claude-code-karma, which has 329 GitHub stars. The repository was last updated on September 28, 2026.

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