pi-finder-subagent

Name: pi-finder-subagent
Author: cowork-os

github.com/cowork-osDevelopment51449 installsUpdated today

About pi-finder-subagent

A read-only local workspace scout subagent for Pi that finds relevant files and snippets before implementation. It returns cited paths and line ranges, plus a saved report, to narrow coding context.

Key features

01Searches the local workspace
02Returns cited files and line ranges
03Saves a finder report
04Accepts query and scope hints

Use cases

01Locate files before implementation
02Narrow context for a coding task
03Find relevant snippets in a repository

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cowork-os/cowork-os --skill pi-finder-subagent

After installing, type/pi-finder-subagentin Claude Code to confirm it loaded.

Details

From the project README

Pi-finder-subagent

Purpose

Read-only local workspace scout subagent for Pi. Use it to narrow context to relevant files/snippets before implementation.

Routing

Use when: Use when users ask to scout the local repository, identify relevant files/snippets, or reduce context before coding.
Do not use when: Do not use for remote GitHub-first research across external repositories; use pi-librarian instead.
Outputs: A cited local-file shortlist with line ranges plus a saved report at {artifactDir}/finder-report.md.
Success criteria: Finder completes with concrete file paths, line ranges, and focused next steps that reduce implementation context.

Trigger Examples

Positive

Use the pi-finder-subagent skill for this request.
Help me with pi-finder-subagent.
Use when users ask to scout the local repository, identify relevant files/snippets, or reduce context before coding.
Pi-finder-subagent: provide an actionable result.

Negative

Do not use for remote GitHub-first research across external repositories; use pi-librarian instead.
Do not use pi-finder-subagent for unrelated requests.
This request is outside pi-finder-subagent scope.
This is conceptual discussion only; no tool workflow is needed.

Parameters

Name	Type	Required	Description
query	string	Yes	What to find in the local workspace
scope_hint	string	No	Optional directories/files/symbols to prioritize

Runtime Prompt

Current runtime prompt length: 775 characters.
Runtime prompt is defined directly in ../pi-finder-subagent.json.

Comments

Markdown supported

Details

Author: cowork-os
Repository: cowork-os/cowork-os
Category: Development
Installs: 49
GitHub stars: 514

Report

More skills

All skills

remotion-render

github.com/inference-sh

1.6M

Render videos from React/Remotion component code via inference.sh. Pass TSX code, get MP4. Supports all Remotion APIs: useCurrentFrame, useVideoConfig, spring, interpolate, AbsoluteFill, Sequence. Configurable resolution, FPS, duration, codec. Use for: programmatic video generation, animated graphics, motion design, data-driven videos, React animations to video. Triggers: remotion, render video from code, tsx to video, react video, programmatic video, remotion render, code to video, animated video, motion graphics code, react animation video

improve-codebase-architecture

github.com/mattpocock

1.2M

Scan a codebase for architecture improvement opportunities, present them as a visual HTML report, then dive deep into whichever one you pick.

design-mobile-apps

github.com/designed-by-ai

1.1M

Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML

vercel-react-best-practices

github.com/vercel-labs

848.6k

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.