autoskills

扫描项目技术栈,自动安装最佳 AI agent skills。 用 autoskills CLI 从 skills.sh 安装匹配的 skills。 中文触发:自动技能、安装技能、技能扫描、装技能、autoskills

SKILL.md

GitHub

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 有效