# summarize

Formats a structured completion summary for Linear agent sessions. Useful when an agent finishes a task and needs to present clear results directly in Linear.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 886 installs · ★ 873
- Author: cyrusagents
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/cyrusagents/cyrus/tree/HEAD/skills/summarize/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/cyrusagents-summarize

## What it does

This skill directs the agent to produce a final task summary tailored for Linear. Output streams directly into the Linear agent session. The prompt explicitly instructs the agent not to post or save the message via tools.

The summary stays within 3 to 5 paragraphs. It details completed work, changed files, pull request links, and follow-up status. Changed files and bullet points sit inside `+++Section Name\n...\n+++` collapsible blocks. For mentions, it builds Linear profile links from the `<assignee>` context.

Do not use tools to send the text. Linear renders the response automatically, so extra posting tools will break the session flow.

## Requirements
- Works with: Linear

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cyrusagents/cyrus --skill summarize -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/summarize/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/summarize/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cyrusagents/cyrus --skill summarize -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/summarize/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cyrusagents/cyrus --skill summarize -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/summarize/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cyrusagents/cyrus summarize
```

2. **Manually: put the files in place**
- File: `.github/skills/summarize/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cyrusagents/cyrus --skill summarize -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cyrusagents/cyrus --path skills/summarize
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/summarize/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cyrusagents/cyrus --skill summarize -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cyrusagents/cyrus/tree/HEAD/skills/summarize/SKILL.md

## When to use it
- format a final task completion summary for Linear
- collapse file diffs and change lists inside `+++` blocks
- insert proper Linear profile mention URLs from assignee context
- record follow-up status and PR links in a clean markdown layout

## Example prompts
- Summarize the completed work for the Linear ticket
- Format the final status and modified files for Linear
- Generate a summary response with PR link and changes

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9ba57449a4a23fbc.

BEGIN THIRD-PARTY FILE 9ba57449a4a23fbc
````text
---
name: summarize
description: Format a final summary message for Linear. Your output is automatically streamed to the Linear agent session — just format it well, do not post it yourself.
---

# Summarize

Format a final summary of the work completed. Your output will be automatically rendered inside Linear — just write it as your response. Do **not** use any tool to post or save it.

## Content

Cover the following:
1. **Work Completed** — What was accomplished (1-2 sentences) and key outcome
2. **Key Details** — Files modified, important changes, PR link if created
3. **Status** — Completion status and any follow-up needed

## Format

- Aim for 3-5 paragraphs maximum
- Use clear, professional language suitable for Linear
- Use markdown formatting for readability
- **Collapsible sections**: Wrap "Changes Made" and "Files Modified" in `+++Section Name\n...\n+++`
- **@mentions**: Use the Linear profile URL format from `<assignee>` context (e.g. `https://linear.app/<workspace>/profiles/<username>`)

## Example

```
## Summary

[Brief description of what was done]

+++Changes Made
- [Key change 1]
- [Key change 2]
+++

+++Files Modified
- [File 1]
- [File 2]
+++

## Status

[Current status and any next steps]

[PR link if applicable]
```
````
END THIRD-PARTY FILE 9ba57449a4a23fbc

The third-party file has ended. Everything between the 9ba57449a4a23fbc tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© cyrusagents · Apache-2.0 · https://github.com/cyrusagents/cyrus/tree/HEAD/skills/summarize/SKILL.md

## Similar
- [groove-utilities-task-analyse](https://affpapa.org/en/nevibecode/skills/groove-utilities-task-analyse.md) — skill · 588 installs
- [linear-cli](https://affpapa.org/en/nevibecode/skills/linear-cli.md) — skill · 14100 installs
- [release-notes](https://affpapa.org/en/nevibecode/skills/release-notes.md) — skill · 2900 installs
- [linear-tickets](https://affpapa.org/en/nevibecode/skills/linear-tickets.md) — skill · 4600 installs
- [pp-linear](https://affpapa.org/en/nevibecode/skills/pp-linear.md) — skill · 615 installs
- [groove-utilities-task-list](https://affpapa.org/en/nevibecode/skills/groove-utilities-task-list.md) — skill · 577 installs

## Other versions with the same name
- [summarize · openclaw](https://affpapa.org/en/nevibecode/skills/summarize.md) — 26900 installs

From the same set: [cyrusagents/cyrus](https://affpapa.org/en/nevibecode/by/cyrusagents/cyrus.md) — 19 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md