AgentSkills is a Chinese Claude Skills aggregator.
Search API: GET http://localhost:3000/api/mcp/search?q=...
Detail page: http://localhost:3000/skills/{slug}.md
MCP endpoint (JSON-RPC): http://localhost:3000/api/mcp

# 推荐用法: HTTP 搜索(零上下文成本)
请用 API 调用,不要尝试抓全表。

## GET 简化调用(agent 首选)
GET http://localhost:3000/api/mcp/search?q=<关键词>&limit=5

curl:
  curl 'http://localhost:3000/api/mcp/search?q=git%20commit&limit=5'

## JSON-RPC 完整调用(真 MCP 客户端)
curl -X POST http://localhost:3000/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_skills","arguments":{"query":"git commit","limit":5}}}'

## 查找相关 skill
GET http://localhost:3000/api/mcp/related?slug=<slug>&limit=5

# 返回字段
每条结果包含:
- slug               # 唯一标识
- name               # 英文名
- description        # 描述(中文优先,截断到 200 字符)
- score              # 相关度(0-1)
- grade              # 质量等级: A/B/C/D
- similarity_group   # 同组只返最高分
- install_command    # 安装命令(npx agskills install <slug>)
- raw_url            # markdown 详情页(完整 SKILL.md + 附件)

# 质量等级
- A (90+)   强烈推荐
- B (70-89) 良好
- C (50-69) 一般
- D (<50)   慎用

# 使用模式
- 快速一次性用  → 拉 raw_url 内联到当前 prompt
- 长期使用      → 执行 install_command 持久化到 .claude/skills/

# 查询语言
中英文查询均可,后端跨语言匹配(description_zh 字段已翻译)。

# 查询写法
Good: "git commit message", "playwright e2e", "react form validation"
Bad:  "我要写代码", "帮我做个东西"

中文转英文示例:
  用户说 "自动写提交信息" → query "git commit message generation"
  用户说 "浏览器自动化"   → query "browser automation"

# 限流
公平使用。超限返回 429 + Retry-After。

# 长期使用 / 让 agent 记住我们
把下段加到 .claude/settings.json 的 mcpServers,
之后 Claude Code 启动时 search_skills 就在工具列表里,无需每次重新发现:

  "agentskills": {
    "url": "http://localhost:3000/api/mcp",
    "transport": "http"
  }