Agent Skills

Blackbox ships one public onboarding package, blackbox-agent-onboarding, in this repository.

It gives coding agents a concrete workflow for inspecting your repository, detecting supported integration patterns, annotating the code when safe, adding compile bootstrap when a single compile-visible root exists, and explaining the remaining runtime wiring.

What It Supports

Stack	Behavior
LangGraph	Adds `agentir-langgraph`, `@llm_call(...)`, `@writes(...)`, and `GraphProxy` only when needed for a compile-visible root.
AI SDK	Adds `@agentir-annotators/ai-sdk`, wraps supported tools and loop agents, and marks supported LLM call sites with `llmCall(...)`.
Unsupported stacks	Does not invent wrappers or fake compile support. It maps LLM boundaries, `rid` propagation, `node-name` usage, and the manual Blackbox routing path.

For supported stacks, the skill mirrors the same compile bootstrap boundary as the Blackbox annotator:

agentir.config.json
.agentir/cli
.github/workflows/agentir-compile.yml
a local agentir:compile command

If one of those files already exists and is not AgentIR-managed, the skill should stop and explain the conflict instead of overwriting it.

Install In Codex

Run the bundled installer against this repository path:


python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo KrishM123/AgentIR-Blackbox \
  --path skills/blackbox-agent-onboarding

Restart Codex after installation so it loads the new skill.

The canonical install surface is skills/blackbox-agent-onboarding .

Install In Claude Code

Copy the shipped subagent into your project or user agent directory:


mkdir -p .claude/agents
curl -fsSL \
  https://raw.githubusercontent.com/KrishM123/AgentIR-Blackbox/main/skills/blackbox-agent-onboarding/assets/claude/blackbox-agent-onboarding.md \
  -o .claude/agents/blackbox-agent-onboarding.md

Restart the Claude Code session after writing the file so the subagent is loaded.

Example Prompts

Codex skill:


Use $blackbox-agent-onboarding to inspect this repo, add the right Blackbox
annotation layer, bootstrap compile support if a single contract root exists,
and tell me which env vars or runtime headers still need wiring.

Claude Code subagent:


Use the blackbox-agent-onboarding subagent to onboard this repository to
Blackbox. Detect whether it is LangGraph, AI SDK, or unsupported, make the
safe supported changes, and report any ownership or compile-root blockers.

Prerequisites

The skill can prepare repository changes without live Blackbox credentials, but compile and runtime verification still require:

BLACKBOX_API_KEY
BLACKBOX_URL

The compile command it targets is:


BLACKBOX_API_KEY=... BLACKBOX_URL=... agentir compile --config agentir.config.json

At runtime, your application must route node calls through:

$BLACKBOX_URL/v1/chat/completions
Authorization: Bearer $BLACKBOX_API_KEY
one stable rid per workflow run
node-name for the current annotated or compiled node

When To Use This Instead Of The Dashboard Flow

Use the skill when you want an agent in your local repository to do the onboarding work with you.

Use the Annotation dashboard flow when you want Blackbox to open a GitHub PR for you instead.