Provider Overview
Solutioneer has two optional providers. Neither is required; both change what the skills can do when present.
The two providers
Section titled “The two providers”| Provider | What it does | When Codex uses it |
|---|---|---|
| Firecrawl | Grounded web research (search, scrape, crawl, map, interact) | When a skill needs evidence for an external claim. |
| Composio | External writeback to Google Docs, Sheets, Confluence, Linear, GitHub | Only when you explicitly ask for a writeback and confirm the destination. |
Environment loading
Section titled “Environment loading”Both providers are configured via environment variables. Solutioneer loads them in this order:
.env.env.localprocess.env(overrides file values)
The minimum .env for both providers looks like:
FIRECRAWL_API_KEY=fc-...COMPOSIO_API_KEY=cmp-...You can set one, both, or neither. Each skill degrades gracefully when a key is missing.
What happens when keys are missing
Section titled “What happens when keys are missing”Without FIRECRAWL_API_KEY:
- Research stays local-only.
- Unsupported external claims must be labelled as assumptions or
unknown. - Skills do not invent account facts, vendor claims, or integration support claims.
Without COMPOSIO_API_KEY:
- External writeback is disabled.
- Google Docs, Google Sheets, Confluence, Linear, and GitHub writes are not attempted.
- The artifact is still returned in chat.
Where to go next
Section titled “Where to go next”- Firecrawl API Key — create a key and drop it into
.env. - Composio API Key — create a key and configure the writeback toolkits.
Once Composio is configured, you will also need to connect the specific toolkits a skill wants to write to. Each toolkit is its own connection: