Use Aidentity from an agent

For agents

Use Aidentity from an agent

The index is designed to be read by machines first. Fetch one JSON file, filter it locally, then fetch the full SKILL.md only for the entries you shortlist. No scraping, no auth, no rate limit beyond GitHub Pages.

Endpoints

File	What it is	Size
search.json	Compact index: id, name, description, tags, license, install, content URL	~461 KB
llms.txt	Key facts and every skill with a one-line description	~461 KB
llms-full.txt	Every skill with metadata, install command and instruction URL	—
registry.json	Full registry, schema-backed	—
catalog.json	Everything: skills, tools, hooks, commands, agents, rules, templates	—
bundles.json	Task-based sets of 5–15 skills	—
agent.json	Manifest: endpoints, counts, usage rules	tiny
ai.txt	Citation and usage preferences	tiny

MCP server

The repository ships a zero-dependency MCP server. It exposes search_skills, recommend, get_skill, list_bundles and install_skill. Install writes are dry-run unless you pass dry_run: false.

node cli/mcp.js

Claude Code

claude mcp add aidentity -- node /absolute/path/to/aidentity/cli/mcp.js

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "aidentity": {
      "command": "node",
      "args": ["/absolute/path/to/aidentity/cli/mcp.js"]
    }
  }
}

Codex — ~/.codex/config.toml

[mcp_servers.aidentity]
command = "node"
args = ["/absolute/path/to/aidentity/cli/mcp.js"]

Gemini CLI — ~/.gemini/settings.json

{
  "mcpServers": {
    "aidentity": {
      "command": "node",
      "args": ["/absolute/path/to/aidentity/cli/mcp.js"]
    }
  }
}

OpenCode — opencode.json

{
  "mcp": {
    "aidentity": {
      "type": "local",
      "command": ["node", "/absolute/path/to/aidentity/cli/mcp.js"],
      "enabled": true
    }
  }
}

Prompts that work

Give these to any agent that can fetch a URL:

Fetch https://akshatnaruka.github.io/aidentity/search.json
Filter for category "testing" and status "stable".
Return the three best matches with their install commands.

Read https://akshatnaruka.github.io/aidentity/llms.txt
I am building a Next.js + Supabase SaaS. Which bundle should I install, and why?

Fetch https://akshatnaruka.github.io/aidentity/agent.json
Store the endpoints. Use search.json for retrieval and content_url for full instructions.

Rules agents must follow

Check content_url. If it is null, the skill is index-only; link upstream, never claim it can be installed.
Check status. Do not recommend in-progress or deprecated entries.
Quote the license. MIT and Apache-2.0 are safe; CC BY-SA is share-alike; proprietary entries need review.
Read before recommending. Fetch the SKILL.md; descriptions are a summary, not the instructions.

Give this URL to an agent: https://akshatnaruka.github.io/aidentity/llms.txt — it starts with the facts an agent needs and links to every machine-readable file.