Skip to content

onboarding-with-agent-skill.md

Latest commit

 

History

History
85 lines (59 loc) · 2.36 KB

onboarding-with-agent-skill.md

File metadata and controls

85 lines (59 loc) · 2.36 KB
Raw

Onboarding With The AgentInbox Skill

If you are already using Codex, Claude Code, or Holon, the recommended onboarding path is to hand the bundled AgentInbox skill to the agent and let it configure the local workflow for you.

This is the preferred path for first-run setup. It avoids pushing the user through raw source add, subscription add, and uxc auth commands before the agent is ready.

If you use the community skills installer, install the bundled skill with:

npx skills add holon-run/agentinbox --skill agentinbox -a codex -a claude-code -a holon

What The Skill Should Do

The bundled skill lives at:

When used for onboarding, the skill should:

  1. verify agentinbox is available in PATH
  2. start or verify the local daemon
  3. verify uxc is available
  4. verify GitHub auth is usable
  5. if gh is already authenticated, import that token into uxc
  6. register the current runtime/session as an agent
  7. use the docs-site examples to add standing GitHub subscriptions

For Holon, registration should use HOLON_AGENT_ID plus HOLON_EXTERNAL_TRIGGER_URL, or pass --webhook-url if the trigger URL is not in the environment.

Recommended Checks

The agent should verify:

agentinbox --version
agentinbox daemon status
uxc --version
gh auth status

If the daemon is not running:

agentinbox daemon start

If GitHub auth should be reused from gh:

uxc auth credential import github --from gh

This requires uxc 0.15.3 or newer:

After Auth

Once uxc can access GitHub and the current runtime/session is registered, the agent can move directly into real usage:

  • add a shared GitHub host plus repo_events or ci_runs streams
  • add standing subscriptions for review comments or CI failures
  • add task-specific subscriptions for a PR or branch
  • remove those subscriptions when the task is done

See:

Why Skill-First

AgentInbox onboarding is still evolving. The skill can absorb environment checks, uxc auth reuse, and per-agent workflow setup without forcing the user to manually learn every low-level CLI step first.