Agent Skills › codeaholicguy/ai-devkit › ai-devkit-setup

ai-devkit-setup

GitHub

用于检查 AI DevKit 本地就绪状态，并在存在 onboarding 或集成缺口时执行针对性设置。通过状态驱动工作流，确保代理配置正确修复并验证结果。

skills/ai-devkit-setup/SKILL.md codeaholicguy/ai-devkit

Trigger Scenarios

用户希望接入 AI DevKit 准备测试环境 harness 修复本地 AI DevKit 集成问题检查是否需要运行设置

Install

npx skills add codeaholicguy/ai-devkit --skill ai-devkit-setup -g -y

More Options

Use without installing

npx skills use codeaholicguy/ai-devkit@ai-devkit-setup

指定 Agent (Claude Code)

npx skills add codeaholicguy/ai-devkit --skill ai-devkit-setup -a claude-code -g -y

安装 repo 全部 skill

npx skills add codeaholicguy/ai-devkit --all -g -y

预览 repo 内 skill

npx skills add codeaholicguy/ai-devkit --list

SKILL.md

Frontmatter

{
    "name": "ai-devkit-setup",
    "description": "AI DevKit · Check local AI DevKit readiness and run setup only when status shows onboarding or harness integration gaps."
}

AI DevKit Setup

Use this skill when a user wants to onboard AI DevKit, prepare a harness, repair local AI DevKit integration, or check whether setup is needed.

Keep the workflow status-driven and simple. Prefer the installed ai-devkit binary; if it is unavailable, use npx ai-devkit@latest.

Execution Notes

Under filesystem sandboxing, run ai-devkit status --json and any ai-devkit setup command outside the sandbox. These commands inspect and modify host-level agent configuration; sandboxed runs can produce false failures or block setup writes, especially for integrations that execute harness commands and access paths like ~/.pi/agent.

Workflow

Run readiness first:
```
ai-devkit status --json
```
Identify failed or warning checks that setup can fix. Setup covers local integrations like hooks, built-in skills, and session tracking for codex, pi, and claude; it does not fix auth, missing package managers, or host tools requiring user installation.
Run the narrowest setup command, for example:
```
ai-devkit setup --agent codex,pi,claude
```
If the user asked for broad onboarding and several supported harnesses need setup, ai-devkit setup is acceptable.
Re-run ai-devkit status --json and report what changed plus any remaining manual actions.

Boundaries

Do not run setup before checking status unless the user explicitly asks to force setup.
Do not claim setup is complete without a fresh status check from this session.
Do not modify secrets, auth tokens, or unrelated harness config manually. Point the user to the failing status item instead.
Ask before destructive cleanup or replacing existing user-managed configuration.
Keep output concise: status command, setup command if run, final readiness, and remaining user actions.