---
name: reposeek
description: Use this skill when the user needs to answer what they can build on before coding. Reposeek finds grounded public repos with reranked summaries and maintenance context.
---

# Reposeek

Use Reposeek to find the repo to build on first. After a candidate is selected, switch to docs or source review for implementation details.

Requires a valid `REPOSEEK_API_KEY` for hosted search.

- macOS menu bar timer app
- self-hosted calendly alternative
- react admin dashboard
- auth library for nextjs

## Workflow

1. Search through the simplest available surface:
   - API: `POST https://api.reposeek.ai/v1/search`
   - CLI: `reposeek search "<query>"`
   - Fallback: `REPOSEEK_API_KEY=*** npx @reposeek/cli@latest search "<query>"`

2. Inspect the response before choosing anything:
   - `request_id`
   - number of returned `results`
   - `rank`
   - `repo`
   - `url`
   - `score`
   - `summary`
   - `stars`
   - `forks`
   - `license`

3. If the reranker score is weak or the result set is sparse, refine the query instead of forcing a choice.

4. Choose the repo that best matches the user's actual use case, stack, and constraints.

5. After selecting a repo, move to current docs or direct source inspection for installation, API usage, and exact code behavior.

Direct API responses include `X-Request-Id`; successful API responses also include `Server-Timing`.

## Notes

- Treat Reposeek output as grounded discovery context, not the final authority on API syntax or exact implementation details.
- Prefer current docs for packages and SDKs.
- Prefer direct README and source inspection for starters, templates, and example apps.