giasip-skills

Cross-runtime agent skills by GiaSip · github.com/GiaSip

giasip-research uses one shared research method with thin Claude Code and Codex runtime mappings. giasip-dispatch remains Claude Code-native.

Skill Structure

skills/
├── giasip-research/
│   ├── SKILL.md                          # Shared method + Claude/Codex runtime mappings
│   ├── agents/openai.yaml                # Codex display, prompt, and invocation metadata
│   └── references/
│       ├── platform-profiles.md          # Deep Research platform capability cards
│       ├── matching-rules.md             # Platform matching decision tree
│       ├── fact-check-protocol.md        # Fact-check protocol (v2.2+v2.4) + Mini Assurance
│       └── subagent-templates.md         # SubAgent instruction templates + unit sanity check
│
└── giasip-dispatch/
    ├── SKILL.md                          # Core skill definition
    ├── scripts/
    │   ├── api-dispatch.sh               # API direct call (DeepSeek/Qwen/GLM/Doubao/MiniMax)
    │   ├── codex-appserver.mjs           # Codex App Server protocol (no cold start)
    │   ├── gemini-supervisor.sh          # Gemini CLI + retry/fallback/circuit breaker
    │   ├── kimi-dispatch.sh              # Kimi dispatch + thinking mode control
    │   ├── dispatch-persist.mjs          # Response logging sink
    │   └── stop-review-gate.mjs          # Codex stop-hook for code review gating
    └── references/
        └── model-roster.md              # Full model roster + multi-dispatch lineup guide

Installation

Option 1: npx skills add (recommended)

# Claude Code: install all skills globally
npx skills add GiaSip/giasip-skills --global --skill '*' --agent claude-code --yes

# Claude Code: install GiaSip Research only
npx skills add GiaSip/giasip-skills --global --skill giasip-research --agent claude-code --yes

# Codex: install GiaSip Research only
npx skills add GiaSip/giasip-skills --global --skill giasip-research --agent codex --yes

# List available skills in this repo
npx skills add GiaSip/giasip-skills -l

Option 2: Claude Code plugin (Claude Code only)

/plugin marketplace add GiaSip/giasip-skills
/plugin install giasip-skills@giasip-skills

Option 3: git clone and copy

git clone https://github.com/GiaSip/giasip-skills
# Claude Code
cp -R giasip-skills/skills/giasip-research ~/.claude/skills/giasip-research
cp -R giasip-skills/skills/giasip-dispatch ~/.claude/skills/giasip-dispatch

# Codex / Agent Skills-compatible hosts
cp -R giasip-skills/skills/giasip-research ~/.agents/skills/giasip-research

Invoke Research as /giasip-research in Claude Code or $giasip-research in Codex. Both hosts may also discover it from a natural-language research request. giasip-dispatch remains Claude Code-native and uses /giasip-dispatch.

Quick Start

1. Install Research for your host:

   # Claude Code
   npx skills add GiaSip/giasip-skills --global --skill giasip-research --agent claude-code --yes
   
   # Codex
   npx skills add GiaSip/giasip-skills --global --skill giasip-research --agent codex --yes
   

2. Try it:

   • Claude Code: /giasip-research Research the current state of humanoid robot regulations
   • Codex: $giasip-research Research the current state of humanoid robot regulations
   • Or simply describe the research task in either host.

giasip-research — Dependencies

Near-zero external dependencies — works out of the box. It maps the same research method onto Claude Code's WebSearch / WebFetch / SubAgents or Codex's available web tools / spawn_agent. If worker concurrency is unavailable, the skill explicitly falls back to sequential facets instead of silently skipping coverage.

The only setup needed: fill in the platform availability table in skills/giasip-research/references/platform-profiles.md with your actual Deep Research subscriptions (ChatGPT / Gemini / Perplexity / Kimi, etc.) — the matching logic uses this to skip unsubscribed platforms.

giasip-dispatch — Dependencies

Two types of dispatch channels; configure what you need:

1. API direct call (just needs an API key — fastest)

Supports DeepSeek / Qwen / GLM / Doubao / MiniMax. Place the corresponding .env file in ~/.config/ai-keys/:

Test (adjust the path to your install location — e.g. a global install): ~/.claude/skills/giasip-dispatch/scripts/api-dispatch.sh --model deepseek "Hello"

Specific model names (e.g., deepseek-v4-pro) are defined in the case branches of api-dispatch.sh and may change as vendors release new versions — update MODEL_ID in the script if a call fails. See references/model-roster.md for the current roster.

2. CLI invocation (requires local install + login)

Dependency check: command -v codex gemini kimi node curl python3 jq perl

Kimi has two backends. The default kimi-dispatch.sh calls the Moonshot API directly (it's really an API channel, not CLI) — needs ~/.config/ai-keys/kimi-moonshot.env containing MOONSHOT_API_KEY, no kimi CLI required. Adding KIMI_FOR_CODING=1 switches to the Kimi CLI coding endpoint — that path needs the kimi CLI installed plus ~/.config/ai-keys/kimi.env containing KIMI_API_KEY.

perl is required by the Gemini and Kimi wrappers for portable timeout control — preinstalled on macOS, but install it on minimal Linux images.

All scripts read keys via source ~/.config/ai-keys/*.env — your keys stay local and are never in this repo.

What's Included

Chinese version

A Chinese reading edition is available under locales/zh/. The installable behavioral source of truth remains the root skills/giasip-research/ directory so the two runtimes cannot drift apart.

Changelog

See CHANGELOG.md for version history.

License

MIT © GiaSip