open-gitagent/run-agent
examples/gitagent-helper/skills/run-agent/SKILL.md
Configures and runs agents with different adapters including Claude, OpenAI, CrewAI, Lyzr, and GitHub Models. Supports local execution, remote git repos, and one-shot prompts. Use when the user wants to run an agent, switch LLM providers, configure adapter settings, or launch agents from git repositories.
$ install --global
skillsauthnpx skillsauth add open-gitagent/gitagent run-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 12:31 AM154.9s1 file scanned
SKILL.md
- name:
- run-agent
- description:
- Configures and runs agents with different adapters including Claude, OpenAI, CrewAI, Lyzr, and GitHub Models. Supports local execution, remote git repos, and one-shot prompts. Use when the user wants to run an agent, switch LLM providers, configure adapter settings, or launch agents from git repositories.
- license:
- MIT
- author:
- gitagent
- version:
- 1.0.0
- category:
- execution
Run Agents
When to Use
When a user wants to run an agent locally, from a git repo, or with a specific adapter/framework.
Troubleshooting
If you see authentication errors:
- Claude: Ensure Claude Code is authenticated (
claude auth status) - OpenAI: Verify
OPENAI_API_KEYis set and valid - GitHub: Check
GITHUB_TOKENhas correct permissions - Lyzr: Confirm
LYZR_API_KEYis active
Basic Usage
# Run local agent with Claude (default)
gitagent run -d ./my-agent
# Run from git repo
gitagent run -r https://github.com/user/agent
# Run with a prompt (one-shot mode)
gitagent run -d ./my-agent -p "Review my code"
Adapters
| Adapter | Flag | Env Var Required | Interactive |
|---------|------|-----------------|-------------|
| Claude | -a claude | (uses Claude Code auth) | Yes |
| OpenAI | -a openai | OPENAI_API_KEY | No |
| CrewAI | -a crewai | — | No |
| OpenClaw | -a openclaw | ANTHROPIC_API_KEY | No (-p required) |
| Nanobot | -a nanobot | ANTHROPIC_API_KEY | Yes |
| Lyzr | -a lyzr | LYZR_API_KEY | No (-p required) |
| GitHub | -a github | GITHUB_TOKEN | No (-p required) |
| Git | -a git | (auto-detects) | Depends |
| Prompt | -a prompt | — | Print only |
Examples
# Claude (interactive)
gitagent run -d ./my-agent
# GitHub Models (one-shot, streaming)
export GITHUB_TOKEN="ghp_..."
gitagent run -d ./my-agent -a github -p "Explain this codebase"
# Lyzr (creates agent on Lyzr Studio + chats)
export LYZR_API_KEY="..."
gitagent run -r https://github.com/user/agent -a lyzr -p "Hello"
# Lyzr one-liner (clone + create + chat)
gitagent lyzr run -r https://github.com/user/agent -p "Hello"
# Auto-detect adapter from repo
gitagent run -r https://github.com/user/agent -a git -p "Hello"
# Just print the system prompt
gitagent run -d ./my-agent -a prompt
Git Caching
Repos cloned via -r are cached at ~/.gitagent/cache/:
# Use cache (default)
gitagent run -r https://github.com/user/agent
# Force refresh
gitagent run -r https://github.com/user/agent --refresh
# No cache (temp dir, deleted after)
gitagent run -r https://github.com/user/agent --no-cache
Auto-Detection (-a git)
The git adapter detects the best runner from the repo:
.gitagent_adapterfile (explicit hint)- Model name (claude-* → claude, gpt-* → openai)
- Framework files (CLAUDE.md, .cursorrules, crew.yaml, .lyzr_agent_id, .github_models)
- Default: claude
Related Skills
open-gitagent/code-review
development
VerifiedTrustedCommunity
Reviews code diffs and files for security vulnerabilities (OWASP Top 10), error handling, complexity, naming conventions, and performance issues. Use when the user asks to review a PR, pull request, diff, merge request, or code changes.
2,723SKILL.mdUpdated Apr 24, 2026
open-gitagent/web-search
development
VerifiedTrustedCommunity
Advanced web search using Tavily API for current information retrieval
2,723SKILL.mdUpdated Apr 24, 2026
open-gitagent/paper-search
development
VerifiedTrustedCommunity
Academic paper search via Google Scholar using Serper API
2,723SKILL.mdUpdated Apr 24, 2026
open-gitagent/knowledge-retrieval
documentation
VerifiedTrustedCommunity
Semantic search over ingested documents using RAG (LlamaIndex/ChromaDB or Foundational RAG)
2,723SKILL.mdUpdated Apr 24, 2026