Agent skill

Harness Gc

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

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

MITAuto-check passed

Install Harness Gc

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

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

GitHub CLI
$ gh skill install k1ein-chen/Harness-Starter harness-gc --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-gc .claude/skills/harness-gc && 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-gc
GitHub stars
119
Token cost
~360 tokens
SKILL.md length
144 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: 外部验证门 — 扫描结果来自 gc-scan.mjs,非 Agent… → 执行与验证分离 — 写代码的 Agent 不给自己打分(Spotify 模式) → Circuit Breaker — 连续 3 次无改善则停止,等你介入 → …
  • SKILL.md covers 核心原则, 触发方式, 扫描维度 and 工作流, plus 2 more sections
  • Calls node

What it does

Harness Gc is an agent skill from k1ein-chen/Harness-Starter. Garbage Collection Agent — 定期扫描项目健康状态,检测文档/代码一致性漂移,自动发起修复提案。

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

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

Example prompts

  • “/harness-gc”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 外部验证门 — 扫描结果来自 gc-scan.mjs,非 Agent 自我报告(Sniff 模式)
  2. 执行与验证分离 — 写代码的 Agent 不给自己打分(Spotify 模式)
  3. Circuit Breaker — 连续 3 次无改善则停止,等你介入
  4. 认知不投降 — 所有修复最终由你 review → 确认

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 Gc loads about 360 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 144 words of instructions outside code blocks.

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

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). 144 words, ~360 tokens.

Download SKILL.mdSave it as .claude/skills/harness-gc/SKILL.md (or your agent's skills folder).
name
harness-gc
description
Garbage Collection Agent — 定期扫描项目健康状态,检测文档/代码一致性漂移,自动发起修复提案。

Harness GC (Garbage Collection) Agent

核心原则

  1. 外部验证门 — 扫描结果来自 gc-scan.mjs,非 Agent 自我报告(Sniff 模式)
  2. 执行与验证分离 — 写代码的 Agent 不给自己打分(Spotify 模式)
  3. Circuit Breaker — 连续 3 次无改善则停止,等你介入
  4. 认知不投降 — 所有修复最终由你 review → 确认

触发方式

方式命令说明
手动node scripts/gc-scan.mjs立即执行一次健康检查
Loop/loop 24h "node scripts/gc-scan.mjs"每 24 小时自动扫描
Routine/schedule daily GC scan at 2am持久化定时(需 Max)

扫描维度

#维度检查项严重性
1CLAUDE.md 完整性必要章节 + 占位符critical / warning
2Git 状态未提交变更数 + 调试残留 (console.log/debugger)info / warning
3TODO/FIXME 密度单文件 >5 处info
4.gitignore 健康node_modules/reviews/loops 遗漏info
5Hook 注册文件存在但未注册/被注释critical / warning
6Harness 状态.harness-state 有效性info / warning
7TypeScript 类型tsc --noEmit 错误(如存在 tsconfig.json)warning
8LSP 配置.lsp.json 有效性info / warning

维度清单以此表为准。代码中 gc-scan.mjs 的 JSDoc 为权威来源。

工作流

TRIGGER → SCAN (gc-scan.mjs) → ANALYZE → PROPOSE (可选) → WAIT (你 review)

状态管理

  • .claude/loops/STATE.md — 当前活跃状态 (hot, 每次会话自动加载)
  • .claude/loops/LOG.md — 历史执行记录 (warm, 按需读取)
  • .claude/.harness-state — Phase/Mode 配置

Circuit Breaker

连续 3 次扫描无改善 → STOP 自动提案 → 标记 Phase: blocked → 等你人工介入。

© 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-gc of k1ein-chen/Harness-Starter.

Open the folder on GitHubat commit c211c43

Compare with similar skills

Harness Gc 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 Gc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Harness Gc this skillk1ein-chen/Harness-Starter119—~360Automated safety check: PassMIT
Garbage CollectionHabitat-Thinking/ai-literacy-superpowers114—~2.2kAutomated safety check: PassCustom licence
Config Gcaffaan-m/ECC277k1 repos~2kAutomated safety check: PassMIT
Debugging Litert GPU Accuracygoogle-ai-edge/LiteRT3.5k—~3.3kAutomated safety check: PassApache-2.0
Alfworld Object Disposerzjunlp/SkillNet1.4k—~341Automated safety check: PassMIT
Alfworld Receptacle Searcherzjunlp/SkillNet1.4k—~709Automated safety check: PassMIT

Similar skills

  • Garbage Collection

    Habitat-Thinking/ai-literacy-superpowers

    This skill should be used when the user asks about "garbage collection rules", "entropy fighting", "documentation staleness", "dead code detection", "convention drift", "periodic checks", "auto-fix…

    114 GitHub stars~2.2k tokensUpdated 20 days ago
    Auto-check passed
  • Config Gc

    affaan-m/ECC

    Garbage collection for your Claude Code configuration. An agent skill from affaan-m/ECC.

    277k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • Debugging Litert GPU Accuracy

    google-ai-edge/LiteRT

    Diagnoses and fixes on-device GPU numerical corruption, garbage generation, zeroed KV caches, and ML Drift delegate lowering bugs for LiteRT and LiteRT-LM models on Android (OpenCL and WebGPU).

    3.5k GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check passed
  • This skill disposes of an object by placing it into a disposal receptacle like a garbage can.

    1.4k GitHub stars~341 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • This skill searches for a specific receptacle (e.g., garbage can, cabinet) by systematically exploring the environment, checking multiple locations until found.

    1.4k GitHub stars~709 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Debug Bo Corruption

    Xilinx/mlir-air

    A skill your agent uses when an NPU kernel passes its standalone shape test but produces NaN, garbage, or stale values when invoked as part of a larger pipeline.

    150 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

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 17 days ago
    Auto-check: notes
  • Harness Start

    k1ein-chen/Harness-Starter

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

    119 GitHub stars~718 tokensUpdated 17 days ago
    Auto-check passed
  • Handover

    k1ein-chen/Harness-Starter

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

    119 GitHub stars~752 tokensUpdated 17 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 17 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 17 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 17 days ago
    Auto-check passed

Questions about Harness Gc

What does Harness Gc do?

Garbage Collection Agent — 定期扫描项目健康状态,检测文档/代码一致性漂移,自动发起修复提案。. Harness Gc is an agent skill from k1ein-chen/Harness-Starter.

How do I install Harness Gc in Claude Code?

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

How do I install Harness Gc in Codex?

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

Can I use Harness Gc 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-gc -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-gc, .gemini/skills/harness-gc, .github/skills/harness-gc and .opencode/skills/harness-gc in your project.

What does Harness Gc need to run?

Going by SKILL.md and its folder, Harness Gc needs the command-line tools its instructions call (node).

Does Harness Gc 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 Gc 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 Gc use?

Harness Gc 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 Gc use?

About 360 tokens (SKILL.md is roughly 1.4k 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 Gc?

Skills that share tags, products or a category with Harness Gc: Garbage Collection (Habitat-Thinking/ai-literacy-superpowers, 114 stars), Config Gc (affaan-m/ECC, 277k stars), Debugging Litert GPU Accuracy (google-ai-edge/LiteRT, 3.5k stars) and Alfworld Object Disposer (zjunlp/SkillNet, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Harness Gc?

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.