skill CX Codex

investigate · cyrusagents — Claude Code skill: what it does, how to install

Q: How do I install investigate in Claude Code?

Run `npx skills add cyrusagents/cyrus --skill investigate -a claude-code` in your terminal.

Researches your repository files and functions, gathers context, and writes answers in Linear Markdown format. Helps when triaging tasks.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add cyrusagents/cyrus --skill investigate -a claude-code

Open on GitHub

What investigate does

The skill executes a four-step investigation workflow: search for relevant files and patterns, read the implementation, collect context with tools, and provide an answer. It skips unnecessary preambles.

Responses follow Linear-compatible markdown standards. Detailed technical sections live inside collapsible blocks written as +++Section Name\n...\n+++. It also attaches file paths and exact line numbers to all code references.

Because the output format targets Linear issues, collapsible +++ tags will look broken in standard markdown viewers.

What it helps with

locate relevant functions and patterns across codebase files
generate Linear-ready research notes with file paths and line numbers
fold verbose implementation details into collapsible markdown blocks

Example prompts for the agent

Investigate how the payment webhook handler works and format the findings for Linear
Find where user roles are verified and cite file paths with line numbers
Research the caching layer implementation and summarize it with collapsible sections

How to install investigate

1Skills CLI (Vercel)

npx skills add cyrusagents/cyrus --skill investigate -a claude-code

2Manually: put the files in place

~/.claude/skills/investigate/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/investigate/

1Skills CLI (Vercel)

npx skills add cyrusagents/cyrus --skill investigate -a codex

2Manually: put the files in place

.agents/skills/investigate/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add cyrusagents/cyrus --skill investigate -a cursor

2Manually: put the files in place

.cursor/skills/investigate/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install cyrusagents/cyrus investigate

2Manually: put the files in place

.github/skills/investigate/SKILL.md

1Skills CLI (Vercel)

npx skills add cyrusagents/cyrus --skill investigate -a gemini-cli

2Platform CLI

gemini skills install https://github.com/cyrusagents/cyrus --path skills/investigate

Manually: put the files in place

.devin/skills/investigate/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add cyrusagents/cyrus --skill investigate -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about investigate

How do I install investigate in Claude Code?

Run npx skills add cyrusagents/cyrus --skill investigate -a claude-code in your terminal.

What does the investigate skill do?

It searches your codebase for functions and files, reads their implementations, and outputs a concise answer with code references.

What output format does investigate produce?

The skill writes Linear-compatible markdown with collapsible sections formatted as +++Section Name\n...\n+++ and exact file line citations.

Source text

SKILL.md · Apache-2.0

---
name: investigate
description: Research the codebase to answer questions. Search for relevant files, gather context, and provide clear answers.
---

# Investigate

Research the codebase and provide a clear, direct answer to the question.

## Approach

1. **Search** — Search the codebase for relevant files, functions, and patterns
2. **Read** — Read necessary files to understand the implementation
3. **Gather context** — Use tools as needed to collect comprehensive information
4. **Answer** — Provide a clear, direct answer using your findings

## Answer Format

- Present in Linear-compatible markdown
- Use `+++Section Name\n...\n+++` for collapsible sections with detailed information
- Include code references with file paths and line numbers
- For @mentions, use the Linear profile URL format from `<assignee>` context (e.g. `https://linear.app/<workspace>/profiles/<username>`)
- Be complete but concise — answer the question directly without unnecessary preamble

investigate by other authors comes first.

investigate ghaida Runs user research from planning to synthesis: interview guides, surveys, usability tests, diary studies, and finding analysis. CX Codex +1 2,700installs investigate launchdarkly Walks through logs, traces, errors, sessions and metrics until it lands on a root cause. Handy when a bug report or odd production behaviour shows up. CX Codex +1 674installs groove-utilities-task-analyse andreadellacorte Pulls tasks from your project backend and groups them by status, so you have something to write into daily memory. CX Codex +1 588installs linear-cli schpet This skill wires the linear CLI into your agent so it can search, create and update Linear issues from the terminal. CX Codex +1 14,100installs release-notes phuryn Creates user-facing release notes from tickets, PRDs, and changelogs. Use it when announcing updates or summarising shipped work. CX Codex +1 2,900installs linear-tickets stablyai This skill runs Linear ticket work through Orca's CLI: read a linked issue, move it through workflow states, close it with a PR link and a comment. CX Codex +1 4,600installs pp-linear Matt Van Horn Runs Linear work from the terminal with local search and cycle reporting. Use it to review assigned work, detect duplicates, or plan a sprint. CX Codex +1 615installs groove-utilities-task-list andreadellacorte Pulls active tasks from your configured backend and shows what is in progress, ready or blocked. Handy as a daily starting view. CX Codex +1 577installs

From the same set18

cyrus-setup-launch Checks Cyrus configuration, prints an integration status summary, and launches the agent as a background service via pm2 or systemd. CX Codex +1 997installs google Searches the web with WebSearch and opens relevant pages through WebFetch. Use it when an agent needs current facts or topic research. CX Codex +1 931installs cyrus-setup-slack Sets up a Cyrus Slack integration through an app created from a prepared manifest. Use it when the agent needs to respond in Slack channels. CX Codex +1 905installs 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. CX Codex +1 886installs implementation Guides the agent to write production-ready code following existing patterns, handle errors, and avoid scope creep before verification. CX Codex +1 850installs verify-and-ship This skill takes finished changes through acceptance checks, tests, changelog updates, commit, push and pull request creation. CX Codex +1 843installs release This skill walks a Cyrus CLI release through trusted publishing: prepare, verify, publish, finish. Useful when a version has to ship without touching packages by hand. CX Codex +1 829installs debug Works through a reported bug from reproduction to a minimal fix. Use it when you need to trace an error and verify the result. CX Codex +1 826installs