autoskills

name	autoskills
description	扫描项目技术栈，自动安装最佳 AI agent skills。 用 autoskills CLI 从 skills.sh 安装匹配的 skills。 中文触发：自动技能、安装技能、技能扫描、装技能、autoskills
tags	["autoskills","skills","install","auto-detect","stack-detection"]
version	1

Goal

• 用 autoskills CLI 扫描项目，自动安装匹配的 AI skills。
• 一行命令搞定，无需手动选。

Use when

• 用户说：自动技能、安装技能、技能扫描、装技能、autoskills、skill 安装、自动装技能
• 用户要给新项目快速配好 AI skills
• 用户想知道项目适合什么 skills

CLI

# 路径
export PATH="$HOME/.npm-global/bin:$PATH"

# 扫描 + 安装（跳过确认）
autoskills -y

# 只预览不装
autoskills --dry-run

# 指定 IDE
autoskills -a claude-code
autoskills -a cursor
autoskills -a claude-code cursor

# 版本
autoskills --version  # v0.2.7

安装位置

• skills 装到 ~/.claude/skills/（symlink → ~/.agents/skills/）

支持的技术栈

• 前端：React, Next.js, Vue, Nuxt, Svelte, Angular, Astro, Tailwind, shadcn/ui
• 后端：Node.js, Express, Hono, NestJS, Go, Spring Boot
• 移动：Expo, React Native, Flutter, SwiftUI
• 数据：Supabase, Prisma, Drizzle, Zod
• 测试：Vitest, Playwright
• 云：Vercel, Cloudflare, AWS, Terraform
• AI：Vercel AI SDK, ElevenLabs, Remotion

Workflow

1. cd 到目标项目目录
2. autoskills --dry-run 先看会装什么
3. autoskills -y 安装
4. 检查 ~/.claude/skills/ 或项目的 .claude/skills/

Manual install fallback（2026-04-23 实测）

• autoskills 的 skills.sh 注册表有部分条目已失效（404）。github/awesome-copilot 的路径从 skills/*.md 改成了 agents/*.agent.md。wshobson/agents 的 skill 在 plugins/<category>/skills/<name>/SKILL.md 子目录内。
• 手动安装流程：
  1. gh api repos/<owner>/<repo>/contents/<path> 获取文件
  2. 用 base64.b64decode(data['content']).decode() 解码
  3. 保存到 ~/.agents/skills/<name>.md
  4. ln -sf "../../.agents/skills/<name>.md" ~/.claude/skills/<name>.md
• 具体路径：
  • github/awesome-copilot: agents/<name>.agent.md
  • wshobson/agents: plugins/<category>/skills/<name>/SKILL.md
  • sickn33/antigravity-awesome-skills: skills/<name>/SKILL.md
• 验证：wc -c 检查文件大小，< 100 字节 = 404 错误页，需删除

Pitfalls

• Node.js >= 22.6.0 必需（当前 v22.13.0 ✓）
• github 源的 skills 可能因网络问题失败，不影响其他源
• 安装可能较慢（从远程下载），设 timeout >= 120s
• npm link 后如 PATH 未更新，用全路径 ~/.npm-global/bin/autoskills
• 安装在 home 目录时会扫描 home 下所有项目文件，可能误检技术栈
• 在具体项目目录下运行更精准
• PATH 问题（2026-04-23 实测）：npm link 装到 ~/.npm-global/bin/ 但该路径不在默认 PATH 中。需 echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc 并重载。或用全路径调用。
• github/awesome-copilot 的 skill 路径已从 skills/*.md 变为 agents/*.agent.md，autoskills 的适配器未跟上，会 404。手动装：

  curl -sL "https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<name>.agent.md" \
    -o "$HOME/.agents/skills/<name>.md"
  ln -sf "../../.agents/skills/<name>.md" "$HOME/.claude/skills/<name>.md"
  

• skills.sh 注册表部分条目已失效（404），autoskills 无法自动处理，需手动验证或跳过
• 安装后检查：ls ~/.claude/skills/ 和 ls ~/.agents/skills/ 确认 symlink 有效