Agent skill

Harness Start

by k1ein-chen in k1ein-chen/Harness-Starter

Entry point for new users — guides through initialization, architecture review, and cleanup.

MITAuto-check passedDevelopment

Install Harness Start

skills CLI
$ npx skills add k1ein-chen/Harness-Starter --skill harness-start -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install k1ein-chen/Harness-Starter harness-start --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/k1ein-chen/Harness-Starter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/harness-start .claude/skills/harness-start && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
harness-start
GitHub stars
119
Token cost
~718 tokens
SKILL.md length
153 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Entry point for new users — guides through initialization, architecture review, and cleanup.

  • Works in 4 steps: :初始化 → :整体看一下架构 → :第一性原理清洗 → …
  • The user first opens this project
  • SKILL.md covers Step 1:初始化, Step 2:整体看一下架构, Step 3:第一性原理清洗 and Step 4:验收 — 检查是否就位, plus 1 more section
  • Calls node

What it does

Harness Start is an agent skill from k1ein-chen/Harness-Starter. Entry point for new users — guides through initialization, architecture review, and cleanup. Use when the user first opens this project or says "开始" / "初始化" / "怎么用".

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Software architecture. The repository describes itself as: 一套成熟完善的开箱即用的 Claude Code Harness Engineering 模板。三层自动化(安全/感知/审查),集成 LSP、OpenSpec SDD 工作流和 AI 一键初始化。新项目和已有项目均可使用。 The licence is MIT.

When your agent uses it

  • The user first opens this project
  • Says 开始 / 初始化 / 怎么用

Example prompts

  • “/harness-start”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. :初始化
  2. :整体看一下架构
  3. :第一性原理清洗
  4. :验收 — 检查是否就位

What it can do on your machine

Read from SKILL.md and the folder at commit c211c43. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Harness Start loads about 718 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 153 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~718

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from k1ein-chen/Harness-Starter at commit c211c43, republished under its MIT licence (© k1ein-chen). 153 words, ~718 tokens.

Download SKILL.mdSave it as .claude/skills/harness-start/SKILL.md (or your agent's skills folder).
name
harness-start
description
Entry point for new users — guides through initialization, architecture review, and cleanup. Use when the user first opens this project or says "开始" / "初始化" / "怎么用".

Harness Start

你是刚打开这个模板的人。无论你手头是空项目还是做到一半的项目,四步走完即可就位。

Step 1:初始化

直接说:

帮我初始化 Harness

AI 会自动执行 harness-init 全流程:检测技术栈 → 填写 CLAUDE.md → 发现 Skill 路由 → 检查 Hook → 安装 LSP → 健康检查。

如果已经在 CLAUDE.md 里填过内容,AI 不会覆盖你写好的部分。

Step 2:整体看一下架构

初始化完成后,说:

帮我梳理一下当前项目架构

AI 会遍历项目文件,输出一份架构概览——目录结构、模块关系、入口文件都在哪里。这一步让你(也让 AI)对项目全貌建立共识,后续改动才有上下文。

Step 3:第一性原理清洗

初始化完成后,AI 已经知道了你的项目是什么。现在基于项目的第一性原理(项目本质、技术栈、核心目标),反向检查 CLAUDE.md 和项目目录里有没有不属于这里的东西。

清洗范围
维度检查什么示例
🧠 CLAUDE.md 规则每条规则是否与项目相关?个人博客不需要 tech-review 引用
📁 项目目录模板文件是否仍残留?scripts/gc-scan.mjs 对于简单项目可能多余
🛠️ 技术栈对齐CLAUDE.md 中提到的技术是否项目在用?纯 Python 项目不应引用 TypeScript
🎯 目标对齐规则是否服务于项目目标?博客项目不需要 CI 检查
执行规范
  1. 每条建议必须说明理由,不得只说"删除"不说"为什么"
  2. 必须等用户确认,用户点头才能改
  3. 用户拒绝的要尊重,不能追问"确定吗"
  4. 一轮最多提 5 条,避免轰炸用户
输出格式
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 第一性原理清洗
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

根据初始化时获取的信息:
  项目类型:{检测到的项目类型}
  技术栈:{检测到的技术栈}
  核心目标:{用户告知的项目目标}

─────────────────────────────────────
清洗建议(共 N 项):

[1/N] CLAUDE.md · {文件位置}
  现状:{当前内容}
  理由:{为什么不符合项目第一性原理}
  建议:{具体修改操作}
  确认?(y/n) →

[2/N] 项目目录 · {文件/目录路径}
  现状:{当前内容}
  理由:{为什么可以删除或修改}
  建议:{具体操作}
  确认?(y/n) →

...

─────────────────────────────────────
所有建议处理完毕,进入下一步验收。

提醒:CLAUDE.md 的行为准则部分(Karpathy 6 条)是通用原则,对所有项目都有价值,不建议裁剪。重点关注的是"进阶特性"和"具体技术引用"。


Step 4:验收 — 检查是否就位

四步执行完毕时,AI 必须执行以下验收检查并输出结果。不得以"做完了"笼统收尾。

检查项
#检查项自动/手动证据来源
1CLAUDE.md 无占位符自动grep '【待填写】' CLAUDE.md → 0 匹配
2第一性原理清洗完成手动确认Step 3 逐条确认记录完整
33 个核心 Hook 已注册自动.claude/settings.json 中 PreToolUse/SessionStart/Stop 齐全
4LSP 可用自动检查 language server 安装状态
5健康检查通过自动node scripts/check.mjs 输出全绿
6项目能正常运行手动确认根据项目类型执行对应的 run 命令
验收输出格式
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 初始化验收报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[#1] ✔ CLAUDE.md 已填写 — 无【待填写】占位符
[#2] ✔ 第一性原理清洗完成 — N 项建议已处理
[#3] ✔ 3 个核心 Hook 已注册 — PreToolUse / SessionStart / Stop
[#4] ✔ LSP 可用 — {language-server}
[#5] ✔ 健康检查通过 — node scripts/check.mjs → 全绿
[#6] ✔ 项目可运行 — {run command} → exit 0

─────────────────────────────────────
结论:全部通过 ✅  项目已就位
─────────────────────────────────────

含 ✘ 的项不处理完毕,四步流程不算结束。


做完四步之后

你的项目就脱离模板状态了。之后正常开发即可——每次会话 AI 会自动加载 git 状态、审查记录和 Loop 状态。

下次打开新项目时,AI 会重新执行以上四步流程,根据新项目的"第一性原理"重新清洗。

关于 tech-review:Harness Starter 内置了技术方案审查能力。当你在开发中要求 AI 实现某个技术方案时,AI 会自动审查该方案在当前行业是否仍然是最佳实践。详见 .claude/skills/tech-review/SKILL.md。

© k1ein-chen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/harness-start of k1ein-chen/Harness-Starter.

Open the folder on GitHubat commit c211c43

Compare with similar skills

Harness Start next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Harness Start compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Harness Start this skillk1ein-chen/Harness-Starter119—~718Automated safety check: PassMIT
Archify Diagramstt-a1i/archify81k—~2.9kAutomated safety check: PassMIT
Electron Multi-Process ArchitectureiOfficeAI/AionUi33k1 repos~1.8kAutomated safety check: PassApache-2.0
Backend Code Reviewlanggenius/dify158k—~676Automated safety check: PassCustom licence
Dark Architecture Diagram BuilderCocoon-AI/architecture-diagram-generator7.4k1 repos~2.1kAutomated safety check: PassMIT
SVG Diagram GeneratorJimLiu/baoyu-skills27k1 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    81k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Tells the agent where new code belongs in an Electron multi-process project and which APIs each process may use, with rules for new bridges, services, agents and workers.

    33k GitHub starsUsed in 1 repo~1.8k tokens
    DevelopmentAuto-check passed
  • Backend Code Review

    langgenius/dify

    Reviews backend code under api/ for concrete, reproducible defects, routes to rule packs for architecture, schema, repositories and SQLAlchemy, and ranks findings from P0 to P3.

    158k GitHub stars~676 tokensUpdated today
    DevelopmentAuto-check passed
  • Dark Architecture Diagram Builder

    Cocoon-AI/architecture-diagram-generator

    Creates dark-themed system, cloud, security and network architecture diagrams as self-contained HTML files with inline SVG and CSS.

    7.4k GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed
  • SVG Diagram Generator

    JimLiu/baoyu-skills

    Creates standalone dark-themed SVG diagrams, including architecture, flowchart, sequence, structural, mind map, timeline and state machine types.

    27k GitHub starsUsed in 1 repo~3.1k tokens
    DevelopmentAuto-check passed
  • Senior Architect Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin…

    260 GitHub starsUsed in 8 repos~1.2k tokens
    DevelopmentAuto-check: notes

More from k1ein-chen/Harness-Starter

  • Harness Init

    k1ein-chen/Harness-Starter

    Initialize this project with the Harness Engineering starter template.

    119 GitHub stars~995 tokensUpdated 16 days ago
    Auto-check: notes
  • Handover

    k1ein-chen/Harness-Starter

    将当前会话中的技术决策、运维流程或阶段性研发进展,归档为标准工程文档(ADR / SOP / Handover),并自动更新模块内的 README 归档索引。

    119 GitHub stars~752 tokensUpdated 16 days ago
    Auto-check passed
  • Harness Mode

    k1ein-chen/Harness-Starter

    Switch Harness workflow mode (full/hotfix/tweak) and development phase (design/build/fix).

    119 GitHub stars~273 tokensUpdated 16 days ago
    Auto-check: notes
  • Tech Review

    k1ein-chen/Harness-Starter

    Reviews technical decisions before implementation. An agent skill from k1ein-chen/Harness-Starter.

    119 GitHub stars~396 tokensUpdated 16 days ago
    Auto-check passed
  • Verify Goal

    k1ein-chen/Harness-Starter

    Independently verifies whether a completed task meets its defined goal conditions.

    119 GitHub stars~502 tokensUpdated 16 days ago
    Auto-check passed
  • Harness Gc

    k1ein-chen/Harness-Starter

    Garbage Collection Agent — 定期扫描项目健康状态,检测文档/代码一致性漂移,自动发起修复提案。

    119 GitHub stars~360 tokensUpdated 16 days ago
    Auto-check passed

Categories

Questions about Harness Start

What does Harness Start do?

Entry point for new users — guides through initialization, architecture review, and cleanup. Harness Start is an agent skill from k1ein-chen/Harness-Starter. Entry point for new users — guides through initialization, architecture review, and cleanup.

When should I use Harness Start?

Harness Start fits situations like: the user first opens this project; says 开始 / 初始化 / 怎么用.

How do I install Harness Start in Claude Code?

Run `npx skills add k1ein-chen/Harness-Starter --skill harness-start -a claude-code`. Or copy the skill folder (.claude/skills/harness-start in k1ein-chen/Harness-Starter) into .claude/skills/harness-start in your project. Claude Code loads it when a task matches its description.

How do I install Harness Start in Codex?

Run `npx skills add k1ein-chen/Harness-Starter --skill harness-start -a codex`. Or copy the skill folder (.claude/skills/harness-start in k1ein-chen/Harness-Starter) into .agents/skills/harness-start in your project. Codex loads it when a task matches its description.

Can I use Harness Start in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add k1ein-chen/Harness-Starter --skill harness-start -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/harness-start, .gemini/skills/harness-start, .github/skills/harness-start and .opencode/skills/harness-start in your project.

What does Harness Start need to run?

Going by SKILL.md and its folder, Harness Start needs the command-line tools its instructions call (node). Our summary lists: Python 3.

Does Harness Start access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Harness Start safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Harness Start use?

Harness Start is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Harness Start use?

About 718 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Harness Start?

Skills that share tags, products or a category with Harness Start: Archify Diagrams (tt-a1i/archify, 81k stars), Electron Multi-Process Architecture (iOfficeAI/AionUi, 33k stars), Backend Code Review (langgenius/dify, 158k stars) and Dark Architecture Diagram Builder (Cocoon-AI/architecture-diagram-generator, 7.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Harness Start?

k1ein-chen (a GitHub user) maintains it in k1ein-chen/Harness-Starter, which has 119 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 24, 2026.

Source: k1ein-chen/Harness-Starter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.