smithery/mksteady

project-onboard

Use this skill when entering a new or legacy project for the first time, to scan and localize global skills for project-specific conventions.

Installation

$ npx skills add smithery/mksteady --skill project-onboard

Summary

  • Use this skill when entering a new or legacy project for the first time, to scan and localize global skills for project-specific conventions.
  • Triggers on "onboard", "init skills", "localize skills", "project setup", or when Claude detects an unfamiliar codebase that would benefit from adapted workflows.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/mksteady.

npx skills add smithery/mksteady

Browse all from smithery/mksteady

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,407 B
  • docs SUMMARY.md 327 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Project Onboarding

分析项目,把全局 skills 本地化到 .skills/。

流程

  1. 探索项目 — 用 Glob/Read 看目录结构、配置文件、代码样本
  2. 理解规范 — 从代码推断项目的测试、lint、commit 等规范
  3. 扫描全局 skills — ls ~/.claude/skills/
  4. 对比分析 — 哪些 skill 需要适配?哪些直接可用?
  5. 交互确认 — 列出建议,让用户选择
  6. 生成 .skills/ — 写入本地化版本

排除列表(不参与本地化)

以下元 skills 默认跳过,除非用户明确要求:

project-onboard    # 本 skill
skill-cleanup      # 清理工具
skill-builder      # 创建工具
skill-creator      # 创建工具
skill-install      # 安装工具
skill-sync         # 同步工具
workflow-analyze   # 分析工具

这些是管理 skills 的工具,不是项目工作流的一部分。

探索时重点看

配置文件: package.json, pyproject.toml, Makefile, tsconfig.json
CI/CD: .github/workflows/, .gitlab-ci.yml
规范: .eslintrc, .prettierrc, commitlint.config.js
测试: jest.config.js, pytest.ini, *_test.go
现有 Claude 配置: CLAUDE.md, .claude/

输出格式

.skills/
├── MANIFEST.json      # 简单记录:哪些被本地化了
├── test/
│   └── SKILL.md       # 适配后的 test skill
└── commit/
    └── SKILL.md       # 适配后的 commit skill

MANIFEST.json 示例

{
  "project": "my-app",
  "localized": ["test", "commit"],
  "skipped": ["code"],
  "created": "2024-01-12"
}

本地化适配示例

全局 skill 写的是 npm test,但项目用 jest:

## Pre-flight Checklist
- [ ] Run `jest --coverage`
- [ ] Ensure coverage > 80%

ephemeral 标记

如果是临时任务相关的 skill,在 SKILL.md 开头加注释:

<!-- ephemeral: pr_merged:#123 -->

这样 /skill-cleanup 知道什么时候可以清理。