Agent skill
add-repo
Clone and index a library source repository
Install this agent skill to your Project
npx add-skill https://github.com/blueraai/bluera-knowledge/tree/main/skills/add-repo
SKILL.md
Add Repository to Knowledge Stores
Clone and index a library source repository: $ARGUMENTS
Steps
-
Parse arguments from $ARGUMENTS:
- Extract the git URL (required, first positional argument)
- Extract --name parameter (optional, defaults to repo name from URL)
- Extract --branch parameter (optional, defaults to default branch)
-
Use mcp__bluera-knowledge__execute tool with command "store:create":
- args.name: Store name (from --name or extracted from URL)
- args.type: "repo"
- args.source: The git URL
- args.branch: Branch name (if --branch specified)
-
Display results showing job ID for background indexing:
✓ Cloning https://github.com/facebook/react...
✓ Created store: react (a1b2c3d4...)
Location: ~/.local/share/bluera-knowledge/stores/a1b2c3d4.../
🔄 Indexing started in background
Job ID: job_abc123def456
Check status with: /bluera-knowledge:check-status job_abc123def456
Or view all jobs: /bluera-knowledge:check-status
Error Handling
If creation fails (e.g., invalid URL, network error, git not available):
✗ Failed to clone repository: [error message]
Common issues:
- Check that the git URL is valid and accessible
- Ensure you have network connectivity
- Verify git is installed on your system
- For private repos, check your SSH keys or credentials
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
when-to-query
When to use BK vs Grep/Read for current project
sync
Sync stores from definitions config (bootstrap on fresh clone)
ui
Launch the admin web UI to browse stores, search, and manage knowledge
stores
List all indexed library stores
index
Re-index a knowledge store
test-plugin
Run comprehensive plugin validation test suite
Didn't find tool you were looking for?