This skill should be used when the user asks to "find references", "참고할 만한 거",
"similar implementation", "오픈소스 있나", "how others do this", "레퍼런스 찾아줘",
or needs to find existing patterns (internal) and open-source examples (external)
for implementing a feature.
This skill should be used when the user asks to "find references", "참고할 만한 거",
"similar implementation", "오픈소스 있나", "how others do this", "레퍼런스 찾아줘",
or needs to find existing patterns (internal) and open-source examples (external)
for implementing a feature.
version
2.0.0
validate_prompt
Must contain all of these sections:
- Internal References section (with content or "No existing patterns found" message)
- GitHub References section with at least 1 repo entry including stars, license, and updated date
- At least 1 repo with actual code excerpt (Key Code block with real source lines)
- Usage Suggestions section with numbered recommendations
Output must start with "## Reference Seek:" header.
Find internal patterns, quality-filtered GitHub repos with code-level insights, official docs, and external examples.
Purpose
When building a feature, find what you can reuse or learn from:
Internal: Existing patterns in the codebase
GitHub: Quality-filtered repos with actual code excerpts
Official Docs: context7-powered library documentation
External: Blog posts, tutorials, best practices
Runtime Surface
Claude Code
Use Task(Explore), gh, context7 MCP when available, and WebSearch as
described below.
Codex
Map internal codebase search to hoyeon-code-explorer when installed.
Use Bash-first gh api and curl for GitHub discovery and code excerpts.
Do not require context7 MCP for v1; use it only if already available in the
current runtime. Otherwise, use official docs via the available Codex web
search/fetch surface and label that fallback.
If no native subagent adapter is loaded, perform the internal search directly
with rg and targeted file reads.
Use Cases
"Looking to implement OAuth login — any good references?"
"Find references for implementing a rate limiter"
"How do I implement pagination? Find me some references"
"Any open source projects similar to WebSocket connection management?"
Step 1: Parallel Search (1 message, up to 4 sources)
CRITICAL: Run all available tracks in one message in parallel.
Track
Tool
Purpose
1-A
Task(Explore)
Internal codebase pattern search
1-B
Bash: gh api search/repositories
GitHub repo search (stars-sorted, top 10)
1-C
mcp__context7__resolve-library-id
Library docs ID lookup
1-D
WebSearch
Blog/tutorial search (1 query only)
1-A. Internal Search (Explore agent):
Task(subagent_type="Explore",
prompt="""
Find existing patterns related to [{TOPIC}] in this codebase.
Look for:
- Similar implementations or utilities
- Patterns that could be reused or extended
- Related helper functions or modules
Report as file:line format with brief description of what's reusable.
""")
## Error Handling
| Situation | Response |
|-----------|----------|
| gh not authenticated | Skip 1-B, use WebSearch 3x fallback, add warning at top |
| gh rate limit (403) | Fallback: `gh search repos "{GH_QUERY}" --sort stars --limit 10 --json ...` (different rate limit bucket) |
| GH results 0 | Remove language filter, retry. If still 0, show "No GitHub results found" |
| All repos filtered out | Relax stars to >= 50. If still none, show top 3 with warning badge |
| context7 resolve fails | Omit "Official Docs" section entirely |
| File tree / fetch fails | Skip that repo's deep dive, proceed to next target |
| Explore returns nothing | Show "No existing patterns found in codebase" |
| Topic too vague | Ask user for clarification before proceeding |
