peri: Skill for Claude Code

.claude/skills/project-maturity/SKILL.md

project-maturity is a skill for Claude Code from KonghaYao/peri. It costs 105 tokens per session (3,734 once invoked), scanned A, original, Apache-2.0.

A project health scan that assesses software across eight areas, such as size, tests, linting, dependencies, and language-specific measures. It detects the project’s main programming language and uses the matching checks, with a general fallback for other projects.

In plain words
What is it for?
Use it to assess a project before taking it over, before a release, or during a technical review of code quality and overall project health.
Why use it?
It replaces a broad, subjective review with collected measurements and repeatable commands. It also puts high-risk findings first so they can be addressed sooner.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

This is KonghaYao/peri's own configuration. It tells Claude Code how to work on peri itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything peri configures →

Reuse

Borrowing it

Nothing to install: this file belongs to KonghaYao/peri. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/KonghaYao/peri/main/.claude/skills/project-maturity/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/KonghaYao/peri

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for project-maturity

README.md
[![agentmods](https://agentmods.dev/badge/skills/konghayao/peri/project-maturity.svg)](https://agentmods.dev/skills/konghayao/peri/project-maturity)
Your own site
<a href="https://agentmods.dev/skills/konghayao/peri/project-maturity"><img src="https://agentmods.dev/badge/skills/konghayao/peri/project-maturity.svg" alt="Measured on agentmods" height="20"></a>
Per session 105 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,734 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00105 $0.03734
Opus 5 $0.00053 $0.01867
Sonnet 5 $0.00021 $0.00747
Haiku 4.5 $0.00011 $0.00373

Measured 6d ago against content hash d492c25ff4ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

project-maturity scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/project-maturity/SKILL.md · 429 lines

How it starts

The opening of the file, as written. The whole thing — 429 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project Maturity Scanner

对任意项目进行 8 维度深度成熟度扫描,产出结构化 Markdown 报告。


工作流概览

语言检测 → 加载 Reference → 并行收集 8 维度数据 → 综合评分 → 输出报告

三个核心原则:

  1. 用数据说话,不做主观猜测 — 每个评分背后都有可复现的命令和数据
  2. 先收集后评分 — 禁止在信息不全时下结论
  3. 风险优先 — 高风险项放在报告最前面,方便读者优先关注

Step 1: 语言检测与 Reference 加载

1.1 自动检测

扫描项目根目录,按优先级判断主语言:

信号 判定
Cargo.toml Rust
package.json + tsconfig.json TypeScript
package.json(无 tsconfig) JavaScript/Node
go.mod Go
pyproject.toml / setup.py / requirements.txt Python
pom.xml / build.gradle Java/Kotlin
Gemfile Ruby
CMakeLists.txt C/C++
以上皆无 Generic(通用检查)

多语言项目:按代码量占比识别主语言和次语言,报告中对每种语言分别评估。

1.2 加载语言 Reference

根据检测结果,读对应 reference 文件获取语言特定的检查命令和指标:

  • references/rust.md — Rust 项目
  • references/typescript.md — TypeScript/JavaScript 项目
  • references/python.md — Python 项目
  • references/go.md — Go 项目
  • references/generic.md — 通用回退

Reference 文件包含的内容:

  • 该语言的代码统计命令
  • 测试框架识别与运行命令
  • 静态分析/lint 工具
  • 依赖审计工具
  • 语言特定的成熟度阈值

Step 2: 并行收集 8 维度数据

关键:所有收集操作必须并行执行。不要串行逐个询问。

维度 1:项目规模

用语言 reference 提供的命令统计:

✅ 源代码行数(排除依赖/target/node_modules/build)
✅ 源文件数量
✅ 模块/包/crate 数量
✅ 各模块代码分布(最大的 5 个模块)
✅ 按语言拆分的代码量(多语言项目)

评价标准:

  • 小型 < 5,000 行 | 中型 5k-50k | 大型 50k-200k | 超大型 > 200k
  • 模块化程度 = 模块数量是否与代码规模匹配

维度 2:开发活跃度

✅ 总提交数 + 首次/最后提交日期
✅ 近 30 天提交趋势(每日统计)
✅ 贡献者数量 + Top 3 贡献者占比(识别总线因子)
✅ 活跃分支数 + 标签数
✅ 版本标签命名规范度
✅ 合并提交比例(反映协作模式)

评价标准:

  • 近 30 天日均提交 > 3 → 极度活跃 | 1-3 → 健康 | 0.1-1 → 维护模式 | < 0.1 → 停滞
  • 单人贡献占比 > 90% → 总线风险高
  • 无版本标签 → 发布不规范

维度 3:测试覆盖

分两层检查:单元测试 + 集成/E2E 测试。

✅ #[test] / it() / def test_* 等测试函数数量
✅ 测试目录结构(tests/ 或 __tests__/ 等)
✅ 运行完整测试套件,统计通过/失败/跳过
✅ 各子模块的测试代码行数 vs 源代码行数
✅ 是否有 E2E/集成测试及框架
✅ 是否有覆盖率工具配置(tarpaulin/istanbul/coverage.py 等)
✅ CI 中是否跑测试

评价标准(通用):

  • 测试/源代码比 > 50% → 优秀 | 20-50% → 良好 | 5-20% → 不足 | < 5% → 严重不足
  • 核心模块零测试 → 直接标红
  • CI 不跑测试 → 扣一档

注意:不同语言/框架的测试文化不同。Rust 项目 5% 测试比可能已经不错(大量类型系统保证),但 JS/Python 项目 5% 是严重不足。具体阈值见各语言 reference。

Read the full file on GitHub · 429 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 429 lines · 105 tokens per session scan A d492c25ff4ad

Subscribe to this mod's changes

project-maturity is a skill published in the GitHub repository KonghaYao/peri (160 stars, last pushed yesterday), licensed Apache-2.0. It adds 105 tokens to every session and 3,734 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

qa-testing

Verify your work by actually operating the app or website you changed, instead of assuming it works. Strongly recommended whenever you build, modify, or debug a web app, website, or desktop GUI app. Drive real browsers with the agent-browser CLI and native desktop apps with the cua-driver CLI. These are installed on…

openinterpreter/openinterpreter · 77 tokens

plugin-creator

Create and scaffold plugin directories for Codex with a required .codex-plugin/plugin.json, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries…

openinterpreter/openinterpreter · 86 tokens

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output…

openinterpreter/openinterpreter · 113 tokens

babysit-pr

Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…

openinterpreter/openinterpreter · 114 tokens

skill-creator

Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.

openinterpreter/openinterpreter · 21 tokens

codex-pr-body

Update the title and body of one or more pull requests.

openinterpreter/openinterpreter · 17 tokens