# SkillFed — Skill search, built for AI agents

skillfed.io is a directory of open-source agent skills (SKILL.md convention), enriched with
when-to-use guidance. It is built for reading about skills — what a skill does, when
agents actually pick it, what the research says — for humans and agents alike.

## Search from your agent (wish-based finder)
Your agent sends an abstract wish; skillfed answers with curated matches from a
deduplicated index. Wishes stay abstract — code, files, and plans never leave the machine.
- MCP server: npx -y skillfed-mcp (Node >= 18)
- Python CLI + finder skill: pip install skillfed
- How skillfed works: https://github.com/skill-federation/skill-federation

## Search live (no key, no install)
Literal URLs, not templates: a browsing chat can follow a link but cannot compose one.
- https://skillfed.io/api/q/write-good-git-commit-messages
- Any need: https://skillfed.io/api/q/ + your-need-in-hyphenated-words (5 results)
- Result count of your own: https://skillfed.io/api/search.json?q=<terms>&limit=1-25
Results carry body_url (reviewed snapshot), source_url, page_url/md_url where published.
- How this works from a chat, and what the review covers: https://skillfed.io/chat

## Find skills (static API)
- Catalog index (JSON, paginated): https://skillfed.io/api/index.json
- Per-skill record: https://skillfed.io/api/skills/{owner}/{repo}/{skill}.json
- Every skill page has a markdown mirror: append .md to its URL
- Sitemap: https://skillfed.io/sitemap.xml

## Install a skill
Skills are third-party open-source code. SkillFed indexes and describes them; it does not
audit them and cannot guarantee an open repo is safe — review a skill before installing.
- Each skill page has an Install section with copy-paste commands
- Manual: copy the skill directory into your agent's skills folder, e.g.
  git clone {repo} && cp -r {skill-dir} ~/.claude/skills/

## Research
- Notes on agent-skill research papers, mapped by direction: https://skillfed.io/research
- Long-form field reports & insights: https://skillfed.io/research#reports
- Editorial deep-dives per published batch: https://skillfed.io/blog