future-agi-platform — Claude Code skill: trace and evaluate LLM agents
A skill that walks your coding agent through Future AGI: wiring up tracing, running eval metrics, and self-hosting the platform.
npx skills add reason-machines/trending-skills --skill future-agi-platform -a claude-codeWhat future-agi-platform does
Future AGI is an open-source platform for observing and scoring LLM and agent applications. It covers OpenTelemetry-native tracing, more than 50 evaluation metrics, multi-turn simulations, datasets, an OpenAI-compatible gateway, and guardrails. The skill hands your agent working recipes for each part instead of leaving it to read the docs.
Instrumentation ships as separate packages. Python users install fi-instrumentation plus a framework instrumentor such as traceai-openai, traceai-langchain, traceai-llamaindex, or traceai-crewai. On the TypeScript side there are @traceai/fi-core and @traceai/openai. In code you call register(project_name=...), attach the instrumentor, and later calls get traced without extra work. Evaluation lives in fi.evals: Hallucination, Groundedness, ResponseRelevance, ToneCheck, PIICheck, ToolCallAccuracy. You can run one metric, several at once, or a batch over a dataset.
Self-hosting means cloning the repo, copying futureagi/.env.example to futureagi/.env, filling in keys, and running docker compose up -d; the UI comes up at http://localhost:3031. The SDK registers nothing without FI_API_KEY and FI_BASE_URL in the environment, so set those before the first run. A local deployment also expects Postgres, ClickHouse, Redis, and RabbitMQ connection strings in the same .env file.
What it helps with
- instrument an OpenAI or LangChain agent for tracing
- check model answers for hallucination
- score a whole dataset instead of a single response
- run Future AGI locally with Docker Compose
- add a manual span when no instrumentor exists
Example prompts for the agent
- Wire Future AGI tracing into my Anthropic agent
- Run Hallucination and Groundedness over my dataset responses
- Help me self-host Future AGI with docker compose and set up .env
How to install future-agi-platform
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill future-agi-platform -a claude-code2Manually: put the files in place
~/.claude/skills/future-agi-platform/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/future-agi-platform/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill future-agi-platform -a codex2Manually: put the files in place
.agents/skills/future-agi-platform/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill future-agi-platform -a cursor2Manually: put the files in place
.cursor/skills/future-agi-platform/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills future-agi-platform2Manually: put the files in place
.github/skills/future-agi-platform/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill future-agi-platform -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/future-agi-platformManually: put the files in place
.devin/skills/future-agi-platform/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill future-agi-platform -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about future-agi-platform
How do I install future-agi-platform in Claude Code?
Run npx skills add reason-machines/trending-skills --skill future-agi-platform -a claude-code. The skill file lands at ~/.claude/skills/future-agi-platform/SKILL.md.
What does future-agi-platform do?
It gives your agent instructions for the Future AGI platform: instrumenting apps for tracing, running evaluation metrics, simulations, datasets, and the gateway.
What do I need before using Future AGI?
An FI_API_KEY and an FI_BASE_URL in your environment. Self-hosting also needs Postgres, ClickHouse, Redis, and RabbitMQ alongside Docker Compose.