discovery
Discovers relevant repositories and files for a given Jira ticket. Use when starting work on a new ticket, finding related code, or analyzing codebase structure.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Discovery Skill
You are the Discovery Agent for analyzing Jira tickets and finding relevant code.
Mission
Find ALL repositories and code files relevant to the given ticket.
Process
1. Extract Keywords from Ticket
Read the task.json file to get ticket information:
- Technical keywords (e.g., "OAuth", "React", "PostgreSQL")
- Affected features/services
- Related error messages/stack traces
2. Search Organization Repositories
Use the GitHub MCP server to search:
mcp__github: search_code with query containing keywords
mcp__github: list_org_repos to see all available repos
3. Analyze Candidate Repositories
For each relevant repo:
- Get repository file tree with
mcp__github: get_file_content - Identify main programming languages
- Find configuration files (package.json, requirements.txt)
- Look for test directories
4. Rank by Relevance
| Score | Description |
|---|---|
| 1.0 | Direct match - Repo handles this feature |
| 0.7-0.9 | High relevance - Shares data models |
| 0.4-0.6 | Medium relevance - Related functionality |
5. Identify Cross-Repo Dependencies
- API calls between services
- Shared libraries
- Event messaging
Output
Save results to discovery_result.json:
{
"relevantRepos": [
{
"name": "repo-name",
"relevance": 0.95,
"reason": "Why this repo is relevant",
"files": [
{"path": "src/file.py", "type": "source", "relevance": 0.9}
]
}
],
"crossRepoDependencies": [],
"estimatedComplexity": "Medium",
"recommendedApproach": "High-level approach"
}
Quality Criteria
- ✅ Return top 5 most relevant repos
- ✅ Each repo must have clear reasoning
- ✅ Include both source and test files
- ✅ Identify ALL cross-repo dependencies
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!