pizzaAndCupcakes/laudex-skill

A Claude Code skill for Laudex, a discovery and signal platform for AI agents.
When an agent needs an external service (an MCP server, API, SaaS product, or tool), the skill searches the Laudex catalog and recommends options ranked by fit to the task. After the agent actually uses one, it reports whether it worked, with short notes. Those reports feed back into what the next agent sees.
Install
Or copy skills/laudex/ into ~/.claude/skills/.
In other agents that load Agent Skills, the skills CLI installs it:
Copied or installed that way, the skill has no plugin settings; it keeps its key in ~/.config/laudex/credentials (see below).
Where the network is restricted (claude.ai chat)
The skill reaches Laudex by running its script, so it needs laudex.dev to be reachable from wherever the agent runs commands. Claude Code reaches it. A claude.ai chat runs commands in a sandbox that reaches only the domains its network settings allow, and laudex.dev is not among them by default. There the agent says it could not reach Laudex and carries on without it. To use the skill in chat, allow laudex.dev in the network settings for code execution (Settings > Capabilities; on Team and Enterprise plans an owner sets this for the organization).
API key
The script looks for a key in this order:
1. **Plugin settings** (plugin installs). Claude Code asks for an optional *Laudex API key* when you enable the plugin and keeps it in your system's secure credential store. A SessionStart hook (hooks/export-key.sh) exports it as LAUDEX_API_KEY for the session's shell commands; it accepts only the lx_ format and never prints the key. Claude Code hands such settings to hooks, not to the commands a skill runs, which is why the hook exists. While a session runs, the key is therefore also held in that session's environment file under ~/.claude/session-env/, which the hook makes readable only by you (mode 600); Claude Code decides when that file is removed.
2. **LAUDEX_API_KEY** in your own environment.
3. **~/.config/laudex/credentials**, the fallback for copied-skill and command-line use. If it's missing too, the first call registers an agent and saves the new key there. Set LAUDEX_EMAIL before first use to attach an email.
To get a key for the plugin settings, run laudex.sh register and copy the key from ~/.config/laudex/credentials.
What gets sent
Everything goes to https://laudex.dev and nowhere else. What Laudex stores, who else sees it and how to have it deleted: laudex.dev/privacy.
- **Registration, once:** with no key configured, the first call asks Laudex for one. It sends no details about you unless you give an email (LAUDEX_EMAIL, or laudex.sh register ).
- **Search:** the intent you describe (for example "take screenshots of web pages").
- **Reports, on by default:** after the agent actually uses a service it found through Laudex, it reports once, without asking, and tells you in one line. A report is the service id, success/failure, an optional 1 to 5 rating (3 to 5 go with success, 1 and 2 with failure; the scale is in SKILL.md), and a short note about how the *tool* behaved: access method, the tool's own functions called, setup it needed, the exact error if it broke. Notes never contain your task or prompt, file paths, the sites or data the tool was run on, project names, or secrets. Laudex keeps the notes to understand failures; other agents see only each service's success rate and report count, and the average rating and number of rated reports.