project-building SKILL.md skillA

project-building from howillmakeit/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add howillmakeit/skills/project-building@git:20261027.b7972f3

Pins git:20261027.b7972f3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
howillmakeit/skills
Path
project-building/SKILL.md
Versions recorded
1
Latest version
git:20261027.b7972f3, committed Oct 27, 2026
Size
10,147 bytes
Repository stars
9
License
MIT

建立和持续维护项目的工作方式与文档体系。用户要求创建 AGENTS.md、建立 docs、整理项目交接、沉淀开发或实验流程,或按已有项目规范推进工作时使用。编写或修改文档必须使用内置的 better-notes,核对来源、语言准确性和写作风格。适用于软件和研究项目;单纯概念问答、独立文件编辑或只读状态查询不因此自动触发项目文档写入。.

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

# Project Building

让下一位协作者只需阅读少量入口文件,就能知道项目目标、当前状态、操作方法和下一步,并能追溯重要决定的依据。

## 使用边界

- 区分用户要讨论流程、初始化项目、推进实现,还是整理交接。讨论只交付方案;只读检查只汇报;明确要求建设或维护时再写文件。
- 用户已授权推进项目时,相关文档维护属于工作的一部分,不要求用户逐份确认。发布、推送、停止作业等操作仍遵循本次任务的授权范围。
- 先沿用项目已有结构;按缺口补充,不为套用本 skill 搬迁目录、改技术栈或新增工具。
- 不把一个项目的服务器地址、训练参数、版本目录或历史事故变成所有项目的规则。

## 文档写作:必须使用内置 better-notes

凡本流程涉及编写或修改文档,包括 AGENTS.md、HANDOFF、索引、设计、进度、实验记录与知识笔记,必须先读取并执行 [references/document-writing.md](references/document-writing.md)。该文件会加载内置的 [better-notes/SKILL.md](references/better-notes/SKILL.md) 及其必读参考资料;不能只看规则摘要或模板就直接写作。

内置包包含 better-notes 的完整正文、参考资料、示例、验证脚本和评估场景,无需另行安装 better-notes,也不依赖原目录。按文档对象加载论文与 Obsidian 分支,用户和目标项目的明确要求优先。只读检查和纯代码修改不因此加载全部写作资料。

## 1. 接手:先还原实际项目

读取适用的 AGENTS.md、根 README、PROJECT_HANDOFF.md、docs 索引及本次任务相关设计。查看实际代码入口、构建配置和已有改动;需要运行信息时核对进程、日志和产物,不能只转述旧文档。

确定本次目标、已有成果、必要约束和可验证的完成标准。已有信息足够就推进;只有缺失信息会改变工作范围或关键方案时才询问。

文档与代码冲突时,区分“期望设计”和“实际行为”。保留差异及来源,不能把现有实现直接写成用户已批准的设计。

## 2. 建立入口:规则、现状、证据分开存放

默认提供下面四个入口;已有等价文件时直接沿用并建立链接,不再维护另一套。

| 入口 | 记录内容 | 不放什么 |
| --- | --- | --- |
| 根 AGENTS.md | 项目目标、目录地图、环境、命令、代码约定、真实操作约束、文档入口 | 每次运行的 PID、实时分数、完整历史 |
| 根 PROJECT_HANDOFF.md | 截至什么时间的现状、进行中事项、主要问题、下一步、证据入口 | 逐次操作流水和整段日志 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add howillmakeit/skills/project-building@sha256:39b7fa1e2da4c424

The line at the top of this page pins the label git:20261027.b7972f3, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tvibbqqkd5oasubf.svg)](https://markdownregistry.com/a/art_tvibbqqkd5oasubf)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 27, 2026.

versioncommittedcommitsizeaudit
git:20261027.b7972f3 latest2026-10-27 b7972f3 10,147 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10147 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

GitHub

howillmakeit/skills · 9 stars · license MIT · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tvibbqqkd5oasubf
GET https://markdownregistry.com/api/v1/resolve?ref=howillmakeit/skills/project-building
GET https://markdownregistry.com/api/v1/blob/39b7fa1e2da4c4248d1efae23c204205ae943a6349a73c12d6918d87dc5d419b

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.

More from howillmakeit/skills

ai-paper-writing SKILL.md skill
howillmakeit/skills · ai-paper-writing/SKILL.md · 辅助 AI 论文写作,分两类任务。一是论文主图、方法图、机制图和图形摘要:搜集顶会同类型参考图,写网页生图提示词,用户手动生图后重建为原生可编辑 PPT。二是摘要、Introduction、实验等文字段落:先搜集相关领域顶会的对应段落到文件…
git:20261014.8a3c818 · audit A · 9 stars
better-decision SKILL.md skill
howillmakeit/skills · better-decision/SKILL.md · 帮助用户在多个合理任务之间确定当前优先级,把决策转为可验证的行动。用户说“每天很忙但重要的事没动”“不知道先做什么”“一直准备却没开始”“是不是在用学习或规划逃避”“帮我取舍、找主要矛盾”或要求用 better-decision…
git:20261008.8e53f92 · audit A · 9 stars
better-notes SKILL.md skill
howillmakeit/skills · better-notes/SKILL.md · 编写、整理或重写有事实依据的技术与知识笔记。用户要求“写笔记”“整理知识点”“做学习笔记”“写教程/概念说明”,尤其涉及 API、库、框架、论文、算法或可能随版本变化的内容时使用。笔记对象是论文时,按固定四部分模板写:研究现状和作者动机、方…
git:20261014.8a3c818 · audit A · 9 stars
better-notes SKILL.md skill
howillmakeit/skills · project-building/references/better-notes/SKILL.md · 编写、整理或重写有事实依据的技术与知识笔记。用户要求“写笔记”“整理知识点”“做学习笔记”“写教程/概念说明”,尤其涉及 API、库、框架、论文、算法或可能随版本变化的内容时使用。笔记对象是论文时,按固定四部分模板写:研究现状和作者动机、方…
git:20261027.b7972f3 · audit A · 9 stars
undress SKILL.md skill
howillmakeit/skills · undress/SKILL.md · 去除论文、开源项目、技术博客、简历项目和产品介绍中的包装性语言,基于论文、代码、实验与原始材料,简单说明作者实际复用了什么、修改了什么、实现了什么、验证了什么。用于用户询问“这个工作到底做了什么”“是不是过度包装”“创新点本质是什么”“去掉…
git:20261008.8e53f92 · audit A · 9 stars
video-summary SKILL.md skill
howillmakeit/skills · video-summary/SKILL.md · BibiGPT 风格视频总结:输入 Bilibili / YouTube 视频链接,快速抓取字幕/转写文本,并生成结构化总结(TL;DR、核心要点、章节时间线、金句,支持中英文)。Use when the user shares a…
git:20261008.8e53f92 · audit A · 9 stars

Every file in howillmakeit/skills

Browse by kind, by grade A, or by owner.