Agent Skills › open-gitagent/opengap › run-agent

run-agent

GitHub

用于配置和运行AI代理，支持Claude、OpenAI等多种适配器，可从本地或Git仓库启动，并提供认证排查指南。

examples/gitagent-helper/skills/run-agent/SKILL.md open-gitagent/opengap

Trigger Scenarios

用户想要运行AI代理切换LLM提供商配置适配器设置从Git仓库启动代理

Install

npx skills add open-gitagent/opengap --skill run-agent -g -y

More Options

Non-standard path

npx skills add https://github.com/open-gitagent/opengap/tree/main/examples/gitagent-helper/skills/run-agent -g -y

Use without installing

npx skills use open-gitagent/opengap@run-agent

指定 Agent (Claude Code)

npx skills add open-gitagent/opengap --skill run-agent -a claude-code -g -y

安装 repo 全部 skill

npx skills add open-gitagent/opengap --all -g -y

预览 repo 内 skill

npx skills add open-gitagent/opengap --list

SKILL.md

Frontmatter

{
    "name": "run-agent",
    "license": "MIT",
    "metadata": {
        "author": "gitagent",
        "version": "1.0.0",
        "category": "execution"
    },
    "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."
}

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

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)
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:

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