Claude Code Agent Development
anthropics/claude-plugins-official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
For CLI agents WITHOUT subagent support (e.g., Codex CLI). An agent skill from pchalasani/claude-code-tools.
Install Session Search
$ npx skills add pchalasani/claude-code-tools --skill session-search -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pchalasani/claude-code-tools session-search --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/aichat/skills/session-search .claude/skills/session-search && rm -rf skills-srcUse ~/.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/
Install the "session-search" agent skill from https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-search into .claude/skills/session-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-search", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-searchType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pchalasani/claude-code-tools --skill session-search -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pchalasani/claude-code-tools session-search --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/aichat/skills/session-search .agents/skills/session-search && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "session-search" agent skill from https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-search into .agents/skills/session-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-search", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pchalasani/claude-code-tools --skill session-search -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pchalasani/claude-code-tools session-search --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/aichat/skills/session-search .cursor/skills/session-search && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "session-search" agent skill from https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-search into .cursor/skills/session-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-search", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pchalasani/claude-code-tools.git --path plugins/aichat/skills/session-search--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pchalasani/claude-code-tools --skill session-search -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pchalasani/claude-code-tools session-search --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/aichat/skills/session-search .gemini/skills/session-search && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "session-search" agent skill from https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-search into .gemini/skills/session-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-search", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pchalasani/claude-code-tools session-searchInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pchalasani/claude-code-tools --skill session-search -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/aichat/skills/session-search .github/skills/session-search && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "session-search" agent skill from https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-search into .github/skills/session-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-search", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pchalasani/claude-code-tools --skill session-search -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pchalasani/claude-code-tools session-search --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pchalasani/claude-code-tools.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/aichat/skills/session-search .opencode/skills/session-search && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "session-search" agent skill from https://github.com/pchalasani/claude-code-tools/tree/main/plugins/aichat/skills/session-search into .opencode/skills/session-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-search", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
session-search- GitHub stars
- 2k
- Token cost
- ~657 tokens
- SKILL.md length
- 298 words
- Files
- 1
- Skills in repo
- 17
- Repo updated
- First seen
- Licence
- MIT
At a glance
For CLI agents WITHOUT subagent support (e.g., Codex CLI). An agent skill from pchalasani/claude-code-tools.
- Works in 5 steps: Understand the query: Identify what the… → Search with aichat: Run aichat search… → Parse results: Use jq to extract fields… → …
- Tasks that involve Subagents
- SKILL.md covers Workflow, Output Format, Example and Constraints, plus 1 more section
- Calls curl, sh and uv; reaches astral.sh and sh.rustup.rs
What it does
Session Search is an agent skill from pchalasani/claude-code-tools. For CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns.
Its SKILL.md is about 660 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 Agent Workflows, covering Subagents. The repository describes itself as: Practical productivity tools for Claude Code, Codex-CLI, and similar CLI coding agents. The licence is MIT.
When your agent uses it
- Tasks that involve Subagents
Example prompts
- “/session-search”
Requirements
- Python 3
- Node.js
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Understand the query: Identify what the user is looking for (code patterns,
- Search with aichat: Run aichat search --json -n 10 "[query]" (use
- Parse results: Use jq to extract fields from JSONL output (session_id,
- Deep dive if needed: Read session files at
- Summarize: Return a focused summary with key findings and references
What it can do on your machine
Read from SKILL.md and the folder at commit 0ca7320. 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:
curlshuvcargo
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:
astral.shsh.rustup.rs
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
Session Search loads about 657 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 298 words of instructions outside code blocks.
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.
- NotePipes a well-known installer script into a shellSKILL.md:77
curl -LsSf https://astral.sh/uv/install.sh | sh # uv - NotePipes a well-known installer script into a shellSKILL.md:78
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Rust
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 pchalasani/claude-code-tools at commit 0ca7320, republished under its MIT licence (© pchalasani). 298 words, ~657 tokens.
Download SKILL.mdSave it as
.claude/skills/session-search/SKILL.md (or your agent's skills folder).- name
- session-search
- description
- For CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns.
If you are Claude Code: Do NOT use this skill directly. Use the
session-searchersubagent via the Task tool instead - it handles this more efficiently without polluting your context.
session-search
Search and find previous code agent sessions (Claude-Code or Codex-CLI) for specific work, decisions, or code patterns.
Workflow
- Understand the query: Identify what the user is looking for (code patterns, decisions, specific work, design direction)
- Search with aichat: Run
aichat search --json -n 10 "[query]"(use-g "project"to filter by project) - Parse results: Use
jqto extract fields from JSONL output (session_id, project, created, snippet, file_path) - Deep dive if needed: Read session files at
~/.claude/projects/*/[session-id].jsonl(max 3 files) - Summarize: Return a focused summary with key findings and references
Run aichat search --help to see all options (date filters, branch filters, etc.)
and JSONL field names.
Output Format
Return a concise summary containing:
- Key Findings: 2-3 bullet points answering the query
- Relevant Sessions: Session IDs and dates for reference
- Specific Content: Code snippets or quotes if directly relevant
Format as clean markdown, not raw JSON.
Example
Query: "Find sessions where we discussed authentication design"
aichat search --json -n 10 "authentication design"Summary:
- Session abc123 (Dec 10): Discussed JWT vs session-based auth, decided on JWT
- Session def456 (Dec 8): Implemented refresh token rotation pattern
Constraints
- ALWAYS use
--jsonflag with aichat search (otherwise it spawns interactive UI) - NEVER return raw JSON output to the user - summarize and distill findings
- NEVER read more than 3 session files per query
- If no results found, suggest alternative search terms
- ONLY report information directly observed in files - never infer or extrapolate
Error Handling
If aichat search command fails or is not found, ask user to install:
uv tool install claude-code-tools # Python package
cargo install aichat-search # Rust search TUIPrerequisites:
- Node.js 18+ (for action menus)
- Rust/Cargo (for aichat-search)
If user doesn't have uv or cargo:
curl -LsSf https://astral.sh/uv/install.sh | sh # uv
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Rust© pchalasani, MIT. 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 plugins/aichat/skills/session-search of pchalasani/claude-code-tools.
Open the folder on GitHubat commit 0ca7320
Compare with similar skills
Session Search 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Session Search this skillpchalasani/claude-code-tools | 2k | — | ~657 | Automated safety check: Notes | MIT | |
| Claude Code Agent Developmentanthropics/claude-plugins-official | 38k | 8 repos | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Subagent Driven DevelopmentAsvarox/allkaraoke | 261 | 38 repos | ~1.2k | Automated safety check: Pass | None | |
| Dispatching Parallel Agentsultralisp/ultralisp | 258 | 41 repos | ~1.5k | Automated safety check: Pass | None | |
| Paseo Advisor Second Opiniongetpaseo/paseo | 20k | 1 repos | ~756 | Automated safety check: Pass | Custom licence | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~12k | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
- Official
Subagent Driven Development
Asvarox/allkaraoke
A skill your agent uses when executing implementation plans with independent tasks in the current session
Dispatching Parallel Agents
ultralisp/ultralisp
A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Paseo Advisor Second Opinion
getpaseo/paseo
Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.
Task Observer
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
O2 Review Loop
openobserve/openobserve
Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.
More from pchalasani/claude-code-tools
All 17 skills in this repoRemove AI Patterns
pchalasani/claude-code-tools
Remove AI-writing patterns ("AI-isms") from text using the avoid-ai-writing catalog (conorbronsdon/avoid-ai-writing).
Dynamic Workflow
pchalasani/claude-code-tools
Create, review, run, inspect, pause, resume, and cancel durable JavaScript workflows that coordinate multiple headless Codex agents.
Voxtype Install
pchalasani/claude-code-tools
Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is).
Agent Style
pchalasani/claude-code-tools
Literature-backed English technical-prose writing rules (agent-style, 21 rules).
Msg
pchalasani/claude-code-tools
Inter-agent communication via the msg CLI. An agent skill from pchalasani/claude-code-tools.
Tmux CLI
pchalasani/claude-code-tools
CLI utility to communicate with other CLI Agents or Scripts in other tmux panes; use it only when user asks you to communicate with other CLI Agents or Scripts in other tmux panes.
Related
Categories
Questions about Session Search
What does Session Search do?
For CLI agents WITHOUT subagent support (e.g., Codex CLI). An agent skill from pchalasani/claude-code-tools. Session Search is an agent skill from pchalasani/claude-code-tools., Codex CLI).
When should I use Session Search?
Session Search fits situations like: tasks that involve Subagents.
How do I install Session Search in Claude Code?
Run `npx skills add pchalasani/claude-code-tools --skill session-search -a claude-code`. Or copy the skill folder (plugins/aichat/skills/session-search in pchalasani/claude-code-tools) into .claude/skills/session-search in your project. Claude Code loads it when a task matches its description.
How do I install Session Search in Codex?
Run `npx skills add pchalasani/claude-code-tools --skill session-search -a codex`. Or copy the skill folder (plugins/aichat/skills/session-search in pchalasani/claude-code-tools) into .agents/skills/session-search in your project. Codex loads it when a task matches its description.
Can I use Session Search 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 pchalasani/claude-code-tools --skill session-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-search, .gemini/skills/session-search, .github/skills/session-search and .opencode/skills/session-search in your project.
What does Session Search need to run?
Going by SKILL.md and its folder, Session Search needs the command-line tools its instructions call (curl, sh, uv and cargo). Our summary lists: Python 3; Node.js.
Does Session Search access the network?
SKILL.md names 2 domains. In commands or code: astral.sh and sh.rustup.rs; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Is Session Search safe to install?
Our automated static check of SKILL.md found notes only (pipes a well-known installer script into a shell), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Session Search use?
Session Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Session Search use?
About 657 tokens (SKILL.md is roughly 2.6k 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 Session Search?
Skills that share tags, products or a category with Session Search: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Session Search?
pchalasani (a GitHub user) maintains it in pchalasani/claude-code-tools, which has 2,010 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 5, 2026.
Source: pchalasani/claude-code-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.