Onboarding With The AgentInbox Skill

If you are already using Codex or Claude Code, 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.

What The Skill Should Do

The bundled skill lives at:

• skills/agentinbox/SKILL.md
• /skills/agentinbox/SKILL

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 terminal session as an agent
7. use the docs-site examples to add standing GitHub subscriptions

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.13.3 or newer.

After Auth

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

• add github_repo or github_repo_ci sources
• 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:

• Getting Started
• Review Workflows
• CLI Reference

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.