Skip to content

raystyle/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skills

Claude Code skill 集合。11 个 skill 覆盖浏览器自动化、GitHub 分析、AI 对话、社交数据、代码搜索、代码执行、Markdown 检查、文档转换。

快速导航

Skill 用途 依赖
browse 浏览器自动化基础层(CDP 会话、JS eval、SDK 注入) nushell 插件
github GitHub 结构化搜索(repos/code/issues/prs/commits) nushell 插件 + gh CLI
google Google 搜索 + 文章提取 nushell 插件 + Bun
grok Grok AI 对话(发消息、对话管理、模型切换) nushell 插件 + Bun + Grok 登录
twitter X/Twitter 数据(推文/用户/列表 CRUD) nushell 插件 + Bun + Twitter 登录
nuevo Nushell 经验库 → rule 生成 nushell 插件
bunsh Bun + TypeScript here-string 执行规范 Bun
uvsh Python + uv here-string 执行规范 uv
mdcheck Markdown lint + fix via markdownlint here-string 规范 Bun
md2pdf Markdown → PDF 转换(多模板、自动语言检测) Bun + Typst
astgrep AST 结构化搜索 + 文本搜索(ast-grep + ripgrep) sg + rg

安装

1. Claude 插件

通过 claude-plugins 安装 Nushell MCP server(Skill 的运行时依赖):

/plugin marketplace add https://github.com/raystyle/claude-plugins
/plugin install raystyle@nushell

nushell 插件是自包含的(捆绑 nu 二进制 + browse 等 6 个插件,167 个命令),安装后 Skill 即可运行。无需通过 omc 安装 Nushell。

可选安装其他插件:

/plugin install raystyle@dev-fix       # Windows 编码/换行修复
/plugin install raystyle@statusline    # 状态栏(模型、Context、Git)

2. 基础工具

通过 oh-my-winclaude(omc)安装 Skill 所需的工具:

git clone https://github.com/raystyle/oh-my-winclaude D:\Oh-My-Claude
cd D:\Oh-My-Claude
.\.scripts\init.ps1
omc install base          # gh、git、uv
omc install bun           # browse/google/grok/twitter/bunsh 需要

3. Skill 安装

通过 gh skill CLI(Agent Skills 规范)安装。Skill 位于 skills/ 标准目录下,gh skill 自动发现。

安装

# 全局安装(~/.claude/skills/,所有项目可用)
gh skill install raystyle/skills browse --agent claude-code --scope user --force
gh skill install raystyle/skills github --agent claude-code --scope user --force

# 项目级安装(当前仓库 .claude/skills/)
gh skill install raystyle/skills browse --agent claude-code --scope project --force

--force 覆盖已存在的 skill,--scope user 全局安装,--scope project 仅当前仓库。

更新

# 更新全部已安装 skill
gh skill update --all --force

# 单个 skill 无 GitHub 元数据时,重新安装即可更新
gh skill install raystyle/skills browse --agent claude-code --scope user --force

gh skill update 依赖安装时注入的 GitHub 元数据。首次从 --from-local 或手动拷贝安装的 skill 无此元数据,需重新 gh skill install 覆盖安装。

预览与搜索

# 预览 skill 内容(不安装)
gh skill preview raystyle/skills browse
gh skill preview raystyle/skills browse@v1.0.0    # 指定版本

# 按关键词搜索 GitHub 上的 skill
gh skill search browser
gh skill search "github cli"

版本锁定

# 锁定到指定 git tag
gh skill install raystyle/skills browse@v1.0.0 --agent claude-code --scope user

# 锁定到指定 commit SHA
gh skill install raystyle/skills browse --pin abc1234 --agent claude-code --scope user

本地安装(开发用)

# 从本地目录安装(不经过 GitHub API)
gh skill install ./path/to/repo browse --from-local --agent claude-code --scope project

# 安装到自定义目录(调试用)
gh skill install raystyle/skills browse --agent claude-code --dir /tmp/test-skills

命令速查

命令 用途
gh skill install <repo> <skill> 安装 skill
gh skill update --all 更新已安装 skill
gh skill preview <repo> <skill> 预览(不安装)
gh skill search <query> 搜索 GitHub 上的 skill
gh skill publish 验证并发布 skill 到仓库
Flag 说明
--agent claude-code 目标 agent(必填)
--scope user 全局安装(默认 project
--scope project 项目级安装
--force 覆盖已存在的 skill
--from-local 从本地目录安装
--pin <ref> 锁定到 git tag 或 commit
--dir <path> 自定义安装目录

Skill 详解

browse — 浏览器自动化基础层

基于 nu_plugin_browse(Nushell CDP 插件)的封装层,所有浏览器 skill 的共享基础设施。

命令browser-open/goto/eval/close/ensure | sdk-path/sdk-check/sdk-guard/js-call | dom-texts/dom-count/http-log/http-fetch

关键设计

  • CDP 结构化返回browser-eval 通过 returnByValue 自动将 JS 对象转为 Nu record。禁止 JSON.stringify(字符串转义爆炸)和 Nu 侧 from json(已是结构化数据)
  • SDK 注入 + done 协议--init-script 将 SDK IIFE 注入页面,Service SDK 通过 done() 信号完成就绪检测(15s deadline)。纯 browse-sdk 无 done,分步操作避开超时
  • browser-ensure — 检查 session 状态,已打开跳过,未打开执行 closure。支持 --ready-check 验证 SDK 注入状态
  • 网络调试--trace 拦截 CDP Network 事件(支持 request/response/regex 过滤),--trace-first(互斥)自动追踪所有流量并提取首个含 body 的 ID 配对

github — GitHub CLI 结构化搜索

gh CLI 的 Nushell 封装,将搜索 API 输出转为 Nu 结构化数据,支持管道式过滤/排序/聚合。

命令gh-search-{repos/code/issues/prs/commits/skills} | gh-view-{repo/readme/file/issue/pr/commit} | gh-list-{releases/branches/tags} | gh-api | gh-ready/gh-help

关键设计

  • 三模式查询--query(完整 DSL)、--keywords(AND 关键字)、--phrase(精确短语)
  • URL 兼容<repo> 参数接受 owner/repo 和完整 GitHub URL;gh-view-commit 接受 commit URL
  • Fork 策略--repo 搜代码结果为空时,检查是否 fork → --include-forks → 仍空则 gh-view-file 直读
  • Code search 降级--phrase 自动降级为 keywords(legacy API 限制);qualifier 与 repo: 互斥时改用独立 flag

google — Google 搜索 + 文章提取

通过浏览器会话注入 SDK 控制 Google 搜索框。有头模式运行,首次 CAPTCHA 需手动验证。

命令google-search | extract-article/batch-extract | google-open/close/ready

关键设计

  • 搜索流程google-ensurereadyCheck() → SDK search() 填框提交 → google-wait-results 轮询 → 提取 results
  • CAPTCHA 检测 + 重试google-wait-results 每轮轮询检测 challenged 标志,触发后自动 close + reopen + 重试一次
  • 文章提取 — 独立 extract-article.ts(Bun + Readability + linkedom),不依赖浏览器会话

grok — Grok AI 对话

通过浏览器会话注入 SDK 与 Grok 网页版交互。

命令grok-ask/last | grok-conv/convs | grok-model | grok-delete/delete-all | grok-navigate/home | grok-open/close/ready

关键设计

  • ask 双模式 — 默认返回 500 字符摘要(省 token),--full 取完整回复。grok-last 从 SDK 缓存取(不重发)
  • 对话续接--conv-id 续接已有对话;--attach 通过 DataTransfer 注入文件附件
  • grok-convs 快速模式 — 默认只返回 list() 元数据(1 次 API),--with-last 按需拉取 last question/reply(N 次 API)
  • 模型管理grok-ensure 自动重置为 Auto;grok-model 支持切换和 --list
  • Nu raw string — 长文本必须用 r#'...'#,支持多层 # 自引用安全

twitter — X/Twitter 数据提取

通过浏览器会话注入 SDK 调用 Twitter GraphQL API。

命令tw-home/user-tweets/search/list-tweets/tweet-detail | tw-user-profile/user-id | tw-lists/list-info/list-members/list-add/list-remove | tw-refresh/logs | tw-open/close/ready

关键设计

  • queryId 动态发现 — Twitter GraphQL queryId 随前端版本失效,tw-refresh 从页面 JS chunk 重新抓取
  • API 日志tw-logs 拦截 fetch/XHR 记录所有 API 调用,支持 URL pattern 过滤
  • 列表 CRUD — 完整的 list-info/members/add/remove,返回精简字段
  • Tier3 流程 — eval → guard → check → unwrap 四步,与 grok 共享模式

nuevo — Nushell 经验库 → Rule 自动生成

nu_evo.jsonl 提取 Nushell 内部错误(nu::xxx::yyy),按错误码匹配 .claude/rules/nushell-evo.md 已有条目。新错误确认后写入 rule 文件,成功模式也可追加。Rule 文件全局加载到所有对话。

命令nuevo-analyze · nuevo-add-error · nuevo-add-win · nuevo-review

关键设计

  • 错误匹配nuevo-analyzenu_evo.jsonl 提取最新错误,按 nu::xxx::yyy 错误码匹配 rule 文件已有条目,返回 {status: known/new, suggestion}
  • Rule 生成nuevo-add-error 追加 pitfall 条目,nuevo-add-win 追加成功模式,均为叙事格式(错误码 + 描述 + 代码块),全局加载到所有对话
  • 统计概览nuevo-review 返回 pitfalls/wins 计数 + 最近 5 条 jsonl 错误

bunsh — Bun + TypeScript here-string 执行规范

定义在 Bash 工具中执行 TypeScript 的标准化流程。Bun 内置 API 优先,避免不必要的 npm 依赖。

核心bun --silent run - <<< '...' | Bun 内置(fetch/bun:sqlite/Bun.file/Glob/Bun.spawn) | cheerio/zod/p-limit | --tips 速查

uvsh — Python + uv here-string 执行规范

定义在 Bash 工具中执行 Python 的标准化流程。按需自动安装依赖,无需管理虚拟环境。

核心uv run -q --with <pkgs> - <<< '...' | httpx/polars/duckdb/pydantic/orjson/selectolax | --tips 速查

mdcheck — Markdown lint + fix here-string 规范

定义在 Bash 工具中检查和修复 Markdown 文件的标准化流程。基于 markdownlint 55+ 规则,支持 lint + auto-fix。

核心bun --silent run - <<< '...' | markdownlint sync API + applyFixes | Bun.file/Glob | 5 个典型模式(lint/fix/scan/config/diff) | --tips 速查

astgrep — AST 结构化搜索 + 文本搜索

基于 ast-grep(AST 精确模式匹配)和 ripgrep(通用文本搜索)的统一代码搜索层。

命令sg-search | sg-rewrite | rg-search | sg-langs | sg-check

关键设计

  • 三种 AST 搜索 — pattern 模式(console.log($MSG))、YAML rule 模式、tree-sitter node kind 模式
  • 统一返回格式 — sg/rg 返回相同 {engine, file, line, text, metavars} 结构,可管道合并分析
  • 安全重写sg-rewrite 默认 dry-run 预览,--apply 才写入文件
  • 语言自动检测 — 从文件扩展名或目录内容自动推断 ast-grep 语言

md2pdf — Markdown → PDF 转换

基于 unified/remark AST 解析 → Typst 模板渲染 → PDF 编译,支持多模板自动检测。

核心md2pdf.ts | AST 转换(unified + remark-gfm + unist-util-visit) | 多模板(中文学术报告 GB/T 7713、英文学术论文、技术文档) | 自动语言/代码比/表格密度检测 | Typst 排版输出

联动项目

  • oh-my-winclaude — 基础环境(gh CLI、Bun、uv 等工具链一键安装)
  • claude-plugins — Claude 插件(Nushell MCP server + LSP、Hooks)
  • nushell-evo — Nushell fork,完整的 MCP 命令审计日志
  • nu-browse — 为智能体适配的浏览器 Nushell 插件

About

RAY的私有Claude Code技能

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors