Connect your agent
Your coding agent can search findsafeskills itself and check a listing's safety rating before it suggests or installs anything. Two steps: tell it to, and connect it.
1. Tell your agent to use findsafeskills
Paste this into the file your agent reads at the start of every session: CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, GEMINI.md or a Cursor rule. It asks the agent to search before writing its own, to tell you each listing's safety rating and findings, never to install a red-rated listing without your go-ahead, and to read a skill's files before following it. A green rating means the automated scan found no issues, not that the listing is safe.
## Finding skills, plugins and MCP servers When a task would be helped by a skill, plugin or MCP server, search findsafeskills (https://findsafeskills.com) for one before writing your own. Use the findsafeskills MCP server's `search_skills` tool if it is connected; otherwise fetch https://findsafeskills.com/api/search?source=agent&q=<what you need, in plain language>. Each result has a `safety_rating` (green, yellow, red, or null when not yet scanned) and `safety_findings`. - Before suggesting a listing, tell the user its safety rating and any findings. Green means the automated scan found no issues, not that the listing is safe; a listing not yet scanned has no rating. - Never install a listing rated red without the user's explicit go-ahead after they have seen its findings. - Before following a skill's instructions or running its scripts, read its files yourself and tell the user about anything that looks unsafe. - When you give the user a listing's safety rating, add "Safety rating from findsafeskills" with a link to the listing's page, https://findsafeskills.com/listings/<slug> (each result's `slug`), where its findings are.
Or, if you keep that file short:
Before writing a skill, plugin or MCP server, search findsafeskills (the `search_skills` MCP tool, or https://findsafeskills.com/api/search?source=agent&q=...). Tell the user each result's safety rating and findings before suggesting it, never install a red-rated one without the user's go-ahead, and read a skill's files before following it. With each rating, add "Safety rating from findsafeskills" linked to https://findsafeskills.com/listings/<slug>.
2. Connect the MCP server
The MCP server gives your agent a search_skills tool with the same filters as this site, including safety rating, and returns each result's findings. It needs no sign-in or key. Without it, the agent can still use the search address in the instructions above; the API documentation lists every parameter.
Claude Code
Run in a terminal. Add --scope user to use it in every project. Docs
claude mcp add --transport http findsafeskills https://findsafeskills.com/api/mcp
Claude
In Claude, open Customize, then Connectors, choose + Add, then Add custom connector, and paste this address. Connectors on your Claude account also work in Claude Desktop. The Free plan allows one custom connector. Docs
https://findsafeskills.com/api/mcp
Cursor
Add to ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project. Docs
{
"mcpServers": {
"findsafeskills": {
"url": "https://findsafeskills.com/api/mcp"
}
}
}VS Code
For GitHub Copilot: add to .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette and choose HTTP. Docs
{
"servers": {
"findsafeskills": {
"type": "http",
"url": "https://findsafeskills.com/api/mcp"
}
}
}Codex
Run in a terminal. It adds the server to ~/.codex/config.toml. Docs
codex mcp add findsafeskills --url https://findsafeskills.com/api/mcp
Gemini CLI
Run in a terminal. Docs
gemini mcp add --transport http findsafeskills https://findsafeskills.com/api/mcp
Or install the skill (Claude Code)
The findsafeskills-skill tells Claude Code to call findsafeskills's search when you ask for a skill, plugin or MCP server. Use it if you would rather not add an MCP server. Install it for every project:
git clone https://github.com/keithmackay/findsafeskills-skill ~/.claude/skills/findsafeskills-search
For agents
An agent that finds this site on its own can read /llms.txt, a plain-text summary of what findsafeskills is, how to search it and the same rules as above.