linear-projects-read
List and get Linear projects via CLI (read-only operations)
Best use case
linear-projects-read is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
List and get Linear projects via CLI (read-only operations)
Teams using linear-projects-read should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/linear-projects-read/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How linear-projects-read Compares
| Feature / Agent | linear-projects-read | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
List and get Linear projects via CLI (read-only operations)
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
## Overview CLI tools for reading Linear projects. Requires `LINEAR_API_KEY` set in `<git-root>/.env` or exported in the environment. ## Prerequisites - [bun](https://bun.sh) runtime installed - `LINEAR_API_KEY` set in `<git-root>/.env` or environment ## Commands ### List Projects ```bash bun .opencode/skill/linear-projects-read/list-projects.js [options] ``` **Options:** - `--status <status>` - Filter by status (planned, started, paused, completed, canceled) - `--lead <name>` - Filter by project lead name - `--limit <n>` - Max results (default: 25) - `--json` - Output as JSON **Examples:** ```bash bun .opencode/skill/linear-projects-read/list-projects.js --limit 10 bun .opencode/skill/linear-projects-read/list-projects.js --status started bun .opencode/skill/linear-projects-read/list-projects.js --lead "James Madison" --json ``` --- ### Get Project ```bash bun .opencode/skill/linear-projects-read/get-project.js <project-id-or-name> [options] ``` **Arguments:** - `project-id-or-name` - Project UUID or name (partial match supported) **Options:** - `--json` - Output as JSON **Examples:** ```bash bun .opencode/skill/linear-projects-read/get-project.js "Mount Vernon" bun .opencode/skill/linear-projects-read/get-project.js "Monticello" --json ``` --- ## Output Behavior - Command output is displayed directly to the user in the terminal - **Do not re-summarize or reformat table output** - the user can already see it - Only provide additional commentary if the user explicitly requests analysis, filtering, or summarization - When using `--json` output with tools like `jq`, the processed results are already visible to the user ## Notes - Project names support partial matching (case-insensitive)
Related Skills
gws-gmail-read
Gmail: Read a message and extract its body or headers.
readme-blueprint-generator
Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content.
create-readme
Create a README.md file for the project
twitter-reader
Fetch Twitter/X post content by URL using jina.ai API to bypass JavaScript restrictions. Use when Claude needs to retrieve tweet content including author, timestamp, post text, images, and thread replies. Supports individual posts or batch fetching from x.com or twitter.com URLs.
safe-file-reader
Read files from documents directory safely
deep-reading-analyst
Comprehensive framework for deep analysis of articles, papers, and long-form content using 10+ thinking models (SCQA, 5W2H, critical thinking, inversion, mental models, first principles, systems thinking, six thinking hats). Use when users want to: (1) deeply understand complex articles/content, (2) analyze arguments and identify logical flaws, (3) extract actionable insights from reading materials, (4) create study notes or learning summaries, (5) compare multiple sources, (6) transform knowledge into practical applications, or (7) apply specific thinking frameworks. Triggered by phrases like 'analyze this article,' 'help me understand,' 'deep dive into,' 'extract insights from,' 'use [framework name],' or when users provide URLs/long-form content for analysis.
readme-i18n
Use when the user wants to translate a repository README, make a repo multilingual, localize docs, add a language switcher, internationalize the README, or update localized README variants in a GitHub-style repository.
crafting-effective-readmes
Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.
screen-reader-testing
Test web applications with screen readers including VoiceOver, NVDA, and JAWS. Use when validating screen reader compatibility, debugging accessibility issues, or ensuring assistive technology support.
readme
When the user wants to create or update a README.md file for a project. Also use when the user says 'write readme,' 'create readme,' 'document this project,' 'project documentation,' or asks for help with README.md. This skill creates absurdly thorough documentation covering local setup, architecture, and deployment.
linear-claude-skill
Manage Linear issues, projects, and teams
linear-automation
Automate Linear tasks via Rube MCP (Composio): issues, projects, cycles, teams, labels. Always search tools first for current schemas.