kit-setup

GitHub

协助配置和测试多种AI代理连接,检查环境依赖并执行冒烟测试,指导用户完成CLI登录。支持面板偏好设置修改,确保连接可用且符合安全规范。

plugins/starter-kit-claude/skills/kit-setup/SKILL.md chrisblattman/claudeblattman

Trigger Scenarios

需要验证或安装特定AI代理的连接 遇到AI代理CLI认证或环境配置问题 希望更改默认AI面板提供商

Install

npx skills add chrisblattman/claudeblattman --skill kit-setup -g -y
More Options

Non-standard path

npx skills add https://github.com/chrisblattman/claudeblattman/tree/main/plugins/starter-kit-claude/skills/kit-setup -g -y

Use without installing

npx skills use chrisblattman/claudeblattman@kit-setup

指定 Agent (Claude Code)

npx skills add chrisblattman/claudeblattman --skill kit-setup -a claude-code -g -y

安装 repo 全部 skill

npx skills add chrisblattman/claudeblattman --all -g -y

预览 repo 内 skill

npx skills add chrisblattman/claudeblattman --list

SKILL.md

Frontmatter
{
    "name": "kit-setup",
    "description": "Discover and test optional Claude, Codex, Gemini through Antigravity, and Grok subscription connections. Help with missing CLI or login setup without changing panel defaults."
}

Set up connections

Read neighboring Ask Agents' references/transport.md and this skill's references/host.md. Ask which connection only if unclear. Native local panels need no extra subscription. Optional providers require their own supported CLI and login. Setup does not change panel defaults, global instructions, billing, or top-ups. The Antigravity Auto configuration below changes permissions only with the user's authorization.

  1. Check Node 18+ and the requested connection with node <ask-agents>/scripts/run-agent.mjs --agent <provider> --preflight. Record detected versus authenticated separately. Detection alone is never success. Manually connected providers work without a kit registry; every invocation performs live discovery. Ignore obsolete engines.json availability flags.
  2. For Gemini, discover agy (Antigravity), not gemini. A desktop sign-in alone does not establish CLI authentication; complete an interactive agy login if required. Follow Antigravity unattended setup below to configure and verify command access. Do not grant trust or bypass permissions automatically.
  3. For Grok, follow the Grok setup sequence in neighboring Ask Agents' references/transport.md. Start with node <ask-agents>/scripts/grok-setup.mjs check; it reports binary, Python and selected-home auth metadata without running Grok. Within the requested setup scope, use the helper's explicit install for the pinned official release and login for interactive subscription sign-in (or login --device-auth). Show the selected home before login. A compatible installed Python is discovered automatically unless STARTER_KIT_PYTHON is set; an invalid override is never replaced. Rerun normal preflight before the smoke test. Never ask for tokens in chat, use API credentials, buy subscriptions or enable extra usage.
  4. Test each requested connection with --smoke-test --output-dir <new-private-directory>. This sends only “Reply with exactly: starter-kit-ok” from a new empty temporary folder. No project context. A setup/test request authorizes this small test and, for Antigravity, the harmless command probe below, subject to host approvals. Read the resulting full report and receipt; require a success state and the expected reply. A greeting alone does not verify command access. Grok warnings about model telemetry do not mean billing failure; report them accurately.
  5. For login failure, guide the provider's interactive login and retry only after it is completed. For other failures, report the actual stage and remedy. A failed test remains failed; no fallback or endless retries.

Return a short table: requested service, executable detected, request tested, result/next step. Link retained test receipts if useful. Do not create a durable available:true gate; tests are point-in-time evidence. Never overwrite saved panel preferences. If the user explicitly asks to change those, use Council's preference helper and show the undo command. Setup alone does not prove that a complete multi-provider panel works.

Antigravity unattended setup

Auto is a saved Antigravity CLI preference, not a per-task setup action. Explain that it applies to future CLI sessions, automatically approves workspace edits and routine commands, and requires a supported account and terminal sandbox. Ask before enabling it unless the user has already authorized that change. If Auto is already saved, do not ask again or rewrite it. If the user declines, preserve their settings and report command access separately from authentication.

Configure it directly with the host's filesystem tools; opening a terminal UI is unnecessary:

  1. Read ~/.gemini/antigravity-cli/settings.json as a JSON object, or start with an empty object if the file is absent. If existing JSON is invalid, stop and report the problem rather than replacing it.
  2. Record whether agentMode existed and its prior value for undo. Merge only "agentMode": "auto", preserving every other setting and existing permission rule. Create the parent directory if needed and write atomically, retaining existing file permissions (use owner-only access for a new file). Do not print unrelated settings or credentials. Do not change login, data-sharing preferences, or workspace trust.
  3. Read back the setting. Explain that undo restores the previous agentMode value, or removes that key if it was absent; it must not replace the entire settings file. Ask Agents inherits the saved preference without a mode override. No interactive selection or repeated setup is required.

After the greeting test, create a new empty temporary workspace and a separate prompt file containing: “Run /usr/bin/true exactly once using your terminal tool and report its exit status. Do not read or change files, browse, or use other tools.” Invoke the neighboring Ask Agents runner with --agent gemini --prompt-file <prompt> --cwd <temporary-workspace> --output-dir <new-private-directory>; do not add a mode override or special allow rule. Require a successful receipt, a substantive report, and raw tool events showing the requested command actually exited 0 without a denial. A model's claim alone is insufficient. Keep the prompt, raw events and receipts outside distributed plugin files.

If the probe fails, retain the evidence and report command access as unverified or blocked; do not silently broaden permissions or switch modes/providers. Auto is not available on every account/platform, and explicit Ask/Deny rules can still block commands. Check the actual tool result rather than relying on the startup permission label alone. State any saved setting change even when verification fails. Do not claim the greeting and command probe establish full file, web, MCP, or Council access.

When the user also asks to change their default panel

Read Council's references/panel-execution.md and use its existing scripts/council.py preferences helper. First show the current preference. Save only the providers or preset the user requested, then show the effective selection and settings path. For example, a request for Claude, Codex and Antigravity maps to preferences set --providers claude,codex,gemini. A two-provider request maps to exactly those two names. Do not edit installed skill files or policy.json to customize the panel.

Explain that ~/.config/starter-kit/settings.json is user-owned and shared by Council and Adversarial Review across both host plugins on this computer. It survives plugin updates. This changes panel membership, not model versions or the fresh native synthesis worker. An explicit provider selection for one task overrides the saved default without changing it. Show preferences reset as the command to restore the bundled local-persona defaults; do not execute it unless requested.

Keep connection setup, a trial panel and saving a panel preference distinct. If the user requested a trial, use a small real task with their exact providers and normal fresh synthesis; verify file access and retrieve substantive reports. A successful greeting alone does not verify that workflow. If the user also requested saving the default after a successful trial, save it after that check passes; do not silently replace an unavailable provider. Setup alone launches no Council or review and saves no panel preference. For a requested persistence check in a new session, run Council or Adversarial Review without a provider/mode override so the saved setting is exercised.

Version History

  • a79c756 Current 2026-11-07 15:29
  • b35ff89 2026-11-02 19:25

Same Skill Collection

codex-starter/skills/ask-agents/SKILL.md
codex-starter/skills/done/SKILL.md
codex-starter/skills/prompt/SKILL.md
codex-starter/skills/review-plan/SKILL.md
plugins/starter-kit-claude/skills/adversarial-review/SKILL.md
plugins/starter-kit-claude/skills/ask-agents/SKILL.md
plugins/starter-kit-claude/skills/council/SKILL.md
plugins/starter-kit-claude/skills/done/SKILL.md
plugins/starter-kit-claude/skills/kit-hello/SKILL.md
plugins/starter-kit-claude/skills/prompt/SKILL.md
plugins/starter-kit-codex/skills/adversarial-review/SKILL.md
plugins/starter-kit-codex/skills/ask-agents/SKILL.md
plugins/starter-kit-codex/skills/council/SKILL.md
plugins/starter-kit-codex/skills/done/SKILL.md
plugins/starter-kit-codex/skills/kit-hello/SKILL.md
plugins/starter-kit-codex/skills/kit-setup/SKILL.md
plugins/starter-kit-codex/skills/prompt/SKILL.md
plugins/starter-kit/skills/council/SKILL.md
plugins/starter-kit/skills/done/SKILL.md
plugins/starter-kit/skills/kit-hello/SKILL.md
plugins/starter-kit/skills/kit-setup/SKILL.md
plugins/starter-kit/skills/prompt/SKILL.md
plugins/starter-kit/skills/review-plan/SKILL.md
skills/aniket-me/SKILL.md
skills/announcement-digest/SKILL.md
skills/checkin/SKILL.md
skills/deep-research/SKILL.md
skills/dr-synthesize/SKILL.md
skills/goals-review/SKILL.md
skills/morning-brief/SKILL.md
skills/post-meeting/SKILL.md
skills/pre-meeting-brief/SKILL.md
skills/proposal-revise/SKILL.md
skills/proposal-write/SKILL.md
skills/schedule-query/SKILL.md
skills/setup-project-management/SKILL.md
skills/tax-guide/SKILL.md
skills/tips-curate/SKILL.md
skills/tips-integrate/SKILL.md
skills/tips-scout/SKILL.md
skills/todo-add/SKILL.md
skills/todo-queue/SKILL.md
skills/todo-review/SKILL.md
skills/triage-inbox/SKILL.md
skills/weekly-review/SKILL.md
starter-kit-source/skills/adversarial-review/SKILL.md
starter-kit-source/skills/ask-agents/SKILL.md
starter-kit-source/skills/council/SKILL.md
starter-kit-source/skills/done/SKILL.md

Metadata

Files
0
Version
a79c756
Hash
5b98ed5c
Indexed
2026-11-02 19:25

trang chủ - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-10 03:13
浙ICP备14020137号-1