Skip to content
cccskills
FreePublished on GitHub

run-agent

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.

The English summary is being prepared. Showing the original description.

Works withGitHubOpenAI
See how to install

Files included (1)

  • SKILL.md2.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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_KEY is set and valid
  • GitHub: Check GITHUB_TOKEN has correct permissions
  • Lyzr: Confirm LYZR_API_KEY is active

Basic Usage

# Run local agent with Claude (default)
opengap run -d ./my-agent

# Run from git repo
opengap run -r https://github.com/user/agent

# Run with a prompt (one-shot mode)
opengap run -d ./my-agent -p "Review my code"

Adapters

AdapterFlagEnv Var RequiredInteractive
Claude-a claude(uses Claude Code auth)Yes
OpenAI-a openaiOPENAI_API_KEYNo
CrewAI-a crewai—No
OpenClaw-a openclawANTHROPIC_API_KEYNo (-p required)
Nanobot-a nanobotANTHROPIC_API_KEYYes
Lyzr-a lyzrLYZR_API_KEYNo (-p required)
GitHub-a githubGITHUB_TOKENNo (-p required)
Git-a git(auto-detects)Depends
Prompt-a prompt—Print only

Examples

# Claude (interactive)
opengap run -d ./my-agent

# GitHub Models (one-shot, streaming)
export GITHUB_TOKEN="ghp_..."
opengap run -d ./my-agent -a github -p "Explain this codebase"

# Lyzr (creates agent on Lyzr Studio + chats)
export LYZR_API_KEY="..."
opengap run -r https://github.com/user/agent -a lyzr -p "Hello"

# Lyzr one-liner (clone + create + chat)
opengap lyzr run -r https://github.com/user/agent -p "Hello"

# Auto-detect adapter from repo
opengap run -r https://github.com/user/agent -a git -p "Hello"

# Just print the system prompt
opengap run -d ./my-agent -a prompt

Git Caching

Repos cloned via -r are cached at ~/.gitagent/cache/:

# Use cache (default)
opengap run -r https://github.com/user/agent

# Force refresh
opengap run -r https://github.com/user/agent --refresh

# No cache (temp dir, deleted after)
opengap run -r https://github.com/user/agent --no-cache

Auto-Detection (-a git)

The git adapter detects the best runner from the repo:

  1. .gitagent_adapter file (explicit hint)
  2. Model name (claude-* → claude, gpt-* → openai)
  3. Framework files (CLAUDE.md, .cursorrules, crew.yaml, .lyzr_agent_id, .github_models)
  4. Default: claude

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

The English summary is being prepared. Showing the original description.

open-gitagent/opengap3KUpdated Jul 3, 2026

Model selection by provider health, not task complexity. Tier 0 (local) handles most tasks. Paid models are break-glass only. Fallbacks activate on 429 or timeout — never on perceived task difficulty.

The English summary is being prepared. Showing the original description.

open-gitagent/opengap3KUpdated Jul 3, 2026

Creates and configures agent.yaml files, writes SOUL.md personality definitions, and sets up agent directory structures with skills, tools, and knowledge. Use when the user wants to configure an agent, create agent.yaml, write SOUL.md, set up agent directory structure, or customize agent settings.

The English summary is being prepared. Showing the original description.

open-gitagent/opengap3KUpdated Jul 3, 2026

Reviews financial documents (prospectuses, ADVs, marketing materials) for FINRA 2210 compliance, required disclosures, and balanced presentation. Use when reviewing financial statements, audit documents, regulatory filings, or when the user mentions compliance checks, financial audits, or document verification.

The English summary is being prepared. Showing the original description.

open-gitagent/opengap3KUpdated Jul 3, 2026

Converts agent definitions between frameworks — exports to Claude Code, OpenAI, CrewAI, Lyzr, and GitHub Models formats, and imports from Claude, Cursor, and CrewAI projects. Use when the user wants to convert an agent, migrate to another framework, export to LangChain/AutoGen/CrewAI, or import from existing automation tools.

The English summary is being prepared. Showing the original description.

open-gitagent/opengap3KUpdated Jul 3, 2026

Guides installation of gitagent and creation of first agent with scaffolding, configuration, and validation. Use when the user is new to gitagent, asks how to get started, wants to install gitagent, set up their first agent, or says 'how do I start?'

The English summary is being prepared. Showing the original description.

open-gitagent/opengap3KUpdated Jul 3, 2026

See all skills by open-gitagent

Report a problem with this skill