Agent skill

Linear Agent Writes

by langfuse in langfuse/langfuse

The org policy for what an agent may write to Linear, and how it must be marked.

Custom licenceAuto-check passedAI & LLM Engineering

Install Linear Agent Writes

skills CLI
$ npx skills add langfuse/langfuse --skill linear-agent-writes -a claude-code

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

GitHub CLI
$ gh skill install langfuse/langfuse linear-agent-writes --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/langfuse/langfuse.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/linear-agent-writes .claude/skills/linear-agent-writes && 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-agent-writes
GitHub stars
35k
Token cost
~2.6k tokens
SKILL.md length
1,602 words
Files
2
Skills in repo
33
Repo updated
First seen
Licence
Custom licence

At a glance

The org policy for what an agent may write to Linear, and how it must be marked.

  • Works in 3 steps: Comment — propose, then post (only when… → Edit a description — propose the block,… → Create a ticket — a subticket freely, a…
  • AI & LLM Engineering work in your project
  • SKILL.md covers Default length, Why the taboo went away — and…, End of session: ask once… and The three shapes, plus 6 more sections
  • Calls pnpm; needs LINEAR_API_KEY and LINEAR_TOKEN

What it does

Linear Agent Writes is an agent skill from langfuse/langfuse. The org policy for what an agent may write to Linear, and how it must be marked. Read this before creating a ticket, editing a description, or commenting on a ticket as an agent — "file this in Linear", "comment on the ticket", "create a subticket", "write the handover". Default those writes to a short human description; expand with research only when asked. Also covers the required Linear connection and what to do when there isn't one.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in AI & LLM Engineering. It works with Langfuse. The repository describes itself as: 🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

When your agent uses it

  • AI & LLM Engineering work in your project

Example prompts

  • “file this in Linear”
  • “comment on the ticket”
  • “create a subticket”
  • “/linear-agent-writes”

Requirements

  • A credential in LINEAR_API_KEY
  • A credential in LINEAR_TOKEN

Workflow steps

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

  1. Comment — propose, then post (only when a human must be told something now)
  2. Edit a description — propose the block, then append
  3. Create a ticket — a subticket freely, a top-level one after a yes

What it can do on your machine

Read from SKILL.md and the folder at commit 8b58764. 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

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • LINEAR_API_KEY
    • LINEAR_TOKEN
    • LINEAR_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Linear Agent Writes loads about 2.6k tokens when it runs. Until then it costs about 115 tokens; SKILL.md has 1,602 words of instructions outside code blocks.

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

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 1,602 words (~2,623 tokens).

“Agents may write to Linear, but most writes are proposals first. Show the text you intend to land, get an explicit go-ahead, then write it yourself. Do not silently mutate a ticket the human is mid-session with.”

— opening of SKILL.md by langfuse, Custom licence
name
linear-agent-writes

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/linear-agent-writes of langfuse/langfuse.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 8b58764

Compare with similar skills

Linear Agent Writes 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 Agent Writes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear Agent Writes this skilllangfuse/langfuse35k—~2.6kAutomated safety check: PassCustom licence
Langfuse Integration Pagelangfuse/langfuse-docs246—~3.7kAutomated safety check: PassMIT
Langfuselangfuse/skills299—~2.1kAutomated safety check: NotesMIT
Add Yourself To Team Langfuselangfuse/langfuse-docs246—~548Automated safety check: PassMIT
LangfuseAnil-matcha/awesome-muse-connectors1.3k—~773Automated safety check: PassMIT
AI Observabilityomer-metin/skills-for-antigravity162—~578Automated safety check: PassApache-2.0

Similar skills

  • Langfuse Integration Page

    langfuse/langfuse-docs

    Create a new Langfuse integration page in the langfuse-docs repo.

    246 GitHub stars~3.7k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Langfuse

    langfuse/skills

    Interact with Langfuse and access its documentation: tracing, monitoring, creating datasets, running experiments, and evaluating AI applications.

    299 GitHub stars~2.1k tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-check: notes
  • Add Yourself To Team Langfuse

    langfuse/langfuse-docs

    Add a new team member to Langfuse's canonical team data and shared team table.

    246 GitHub stars~548 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Langfuse

    Anil-matcha/awesome-muse-connectors

    Read and write Langfuse: browse traces and observations, list prompts and datasets, score traces, add dataset items.

    1.3k GitHub stars~773 tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • AI Observability

    omer-metin/skills-for-antigravity

    Implement comprehensive observability for LLM applications including tracing (Langfuse/Helicone), cost tracking, token optimization, RAG evaluation metrics (RAGAS), hallucination detection, and…

    162 GitHub stars~578 tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check passed
  • Langfuse

    HybridAIOne/hybridclaw

    Use Langfuse for LLM observability and evaluation and look up Langfuse documentation.

    158 GitHub stars~3.1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from langfuse/langfuse

All 33 skills in this repo
  • Linear Context Handover

    langfuse/langfuse

    Use Linear as the org's memory: reconstruct a feature's history before touching it, and leave the reasoning behind finished work in the ticket description so the next agent inherits it.

    35k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Add Model Price

    langfuse/langfuse

    A skill your agent uses when editing worker/src/constants/default-model-prices.json, packages/shared/src/server/llm/types.ts, pricing tiers, tokenizer IDs, or matchPattern regexes for OpenAI…

    35k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Backend Dev Guidelines

    langfuse/langfuse

    Build or review Langfuse backend code. An agent skill from langfuse/langfuse.

    35k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Navigate Langfuse repositories, code areas, and agent skills.

    35k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Refactor React Effects

    langfuse/langfuse

    Refactor avoidable React useEffect usage in Langfuse frontend code.

    35k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Add To Dependabot CSV

    langfuse/langfuse

    Append GitHub Dependabot or Snyk/code-scanning alerts to an existing vulnerability CSV after verifying their API metadata.

    35k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Linear Agent Writes

What does Linear Agent Writes do?

The org policy for what an agent may write to Linear, and how it must be marked. Linear Agent Writes is an agent skill from langfuse/langfuse. The org policy for what an agent may write to Linear, and how it must be marked.

When should I use Linear Agent Writes?

Linear Agent Writes fits situations like: AI & LLM Engineering work in your project.

How do I install Linear Agent Writes in Claude Code?

Run `npx skills add langfuse/langfuse --skill linear-agent-writes -a claude-code`. Or copy the skill folder (.agents/skills/linear-agent-writes in langfuse/langfuse) into .claude/skills/linear-agent-writes in your project. Claude Code loads it when a task matches its description.

How do I install Linear Agent Writes in Codex?

Run `npx skills add langfuse/langfuse --skill linear-agent-writes -a codex`. Or copy the skill folder (.agents/skills/linear-agent-writes in langfuse/langfuse) into .agents/skills/linear-agent-writes in your project. Codex loads it when a task matches its description.

Can I use Linear Agent Writes 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 langfuse/langfuse --skill linear-agent-writes -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-agent-writes, .gemini/skills/linear-agent-writes, .github/skills/linear-agent-writes and .opencode/skills/linear-agent-writes in your project.

What does Linear Agent Writes need to run?

Going by SKILL.md and its folder, Linear Agent Writes needs the command-line tools its instructions call (pnpm) and credentials named LINEAR_API_KEY, LINEAR_TOKEN and LINEAR_API_TOKEN. Our summary lists: A credential in LINEAR_API_KEY; A credential in LINEAR_TOKEN.

Does Linear Agent Writes 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 Linear Agent Writes 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 Linear Agent Writes use?

Linear Agent Writes 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 Linear Agent Writes use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Agent Writes?

Skills that share tags, products or a category with Linear Agent Writes: Langfuse Integration Page (langfuse/langfuse-docs, 246 stars), Langfuse (langfuse/skills, 299 stars), Add Yourself To Team Langfuse (langfuse/langfuse-docs, 246 stars) and Langfuse (Anil-matcha/awesome-muse-connectors, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear Agent Writes?

langfuse (a GitHub organization) maintains it in langfuse/langfuse, which has 35,460 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 7, 2026.

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