harness-step1-create-agents-md SKILL.md skillA
harness-step1-create-agents-md from simbajigege/book2skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add simbajigege/book2skills/harness-step1-create-agents-md@git:20260713.a707ed3Pins git:20260713.a707ed3 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- simbajigege/book2skills
- Path
skills/harness-step1-create-agent-md/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260713.a707ed3, committed Jul 13, 2026
- First version recorded
- Apr 14, 2026
- Size
- 8,517 bytes
- Repository stars
- 202
- License
- MIT
Harness Engineering 第一阶段：扫描现有项目，生成 AGENTS.md（目录文件）和完整的 docs/ 知识库结构。 当用户想要"为项目添加 agent 支持"、"让 AI 更好地理解我的项目"、"开始 harness engineering"、 "创建 AGENTS.md"、"搭建 agent 文档结构"、"让 Claude Code 更好地工作"时，立即使用此 skill。 也适用于用户说"帮我把项目文档整理好给 agent 用"、"我想开始用 AI agent 开发"、 "梳理这个项目能解决什么业务问题"或要求建立 business-solution.md 等场景。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Harness Step 1: 创建 AGENTS.md 与 docs/ 知识库 ## 目标 为项目建立 agent 可读的知识库地基： - 一份简短的 `AGENTS.md`（~100 行，作为"目录"而非百科全书） - 一套 `docs/` 目录结构，存放真正的知识 **核心原则**：agent 看不到的东西就不存在。项目的业务定位、目标用户、解决的问题、架构决策、命名约定和技术选型，必须以文件形式存在于仓库中。 --- ## 执行步骤 ### Step 1：扫描项目 按顺序收集项目信息，**已知信息跳过，不要重复提问**： ```bash # 1. 项目根目录结构（2层） find . -maxdepth 2 -not -path '*/node_modules/*' -not -path '*/.git/*' \ -not -path '*/__pycache__/*' -not -path '*/dist/*' -not -path '*/.next/*' | sort # 2. 识别技术栈 cat package.json 2>/dev/null || cat pyproject.toml 2>/dev/null || \ cat go.mod 2>/dev/null || cat Cargo.toml 2>/dev/null || echo "未找到包管理文件" # 3. 查看是否已有文档 ls -la *.md 2>/dev/null; ls -la docs/ 2>/dev/null # 4. 查看 README（如有） head -80 README.md 2>/dev/null || head -80 readme.md 2>/dev/null ``` 从扫描结果中提取： - **项目名称和用途**（从 README 或 package.json） - **业务定位和用户价值**（服务谁、解决什么问题、提供哪些可见能力） - **典型业务场景**（从 README 功能、示例、截图说明和已有产品文档提取） - **技术栈**（语言、框架、主要依赖） - **目录结构**（主要模块划分） - **已有文档**（避免重复，复用现有内容） 业务内容必须区分“仓库明确声明的现有能力”和“根据功能推断的潜在场景”。仅有营销描述、没有代码或产品文档证据的内容标注「待 Step 2 验证」。 ### Step 2：生成 docs/ 目录结构 创建以下文件（内容根据扫描结果填写，不要留空占位符）： **必须创建的文件：** ``` AGENTS.md ← 目录文件，~100行 docs/ …
Read the whole file at its exact version.
How to install
mdr add simbajigege/book2skills/harness-step1-create-agents-md@sha256:625203e5f82a1977The line at the top of this page pins the label git:20260713.a707ed3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_o34ntdb57fcitlsu)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Apr 14, 2026 and Jul 13, 2026, about one every 90 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260713.a707ed3 latest | 2026-07-13 | a707ed3 | 8,517 B | A | view · diff |
| git:20260414.6a7e3e4 | 2026-04-14 | 6a7e3e4 | 7,028 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8517 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
simbajigege/book2skills · 202 stars · license MIT · pushed 2026-08-26 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_o34ntdb57fcitlsu GET https://markdownregistry.com/api/v1/resolve?ref=simbajigege/book2skills/harness-step1-create-agents-md GET https://markdownregistry.com/api/v1/blob/625203e5f82a1977048ab1161a5d477c108de595e4d1f503fa3990cbfcf9446f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.