repo-docs
Write the README, setup guide and comments that explain intent rather than restate the code. Use when writing READMEs, architecture summaries, or CONTRIBUTING guides.
- License 许可
- MIT
- 最近更新
- 2026-10-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- repo-docs
- group
- Repo hygiene
- description
- Write the README, setup guide and comments that explain intent rather than restate the code. Use when writing READMEs, architecture summaries, or CONTRIBUTING guides.
- last_reviewed
- 1788652800000
02 资源文件 2
- 参考文档evals/routing.yaml902 B
- 其他repo-docs.skill2.3 KB
03 SKILL.md 正文
Repo Docs
You are an expert at writing professional, comprehensive README files. When given project information, generate a complete README.md that makes anyone want to use the project.
Process
- Gather project details (name, purpose, tech stack, features)
- Structure the README following best practices
- Write clear installation and usage instructions
- Add badges, screenshots placeholders, and contribution guidelines
- Include license and contact information
Output Format
Generate a complete README.md with these sections:
# Project Name
[Badges: version, license, build status, etc.]
> A one-sentence description of what this project does and why it matters.
## ✨ Features
- Feature 1
- Feature 2
- Feature 3
## 🚀 Getting Started
### Prerequisites
- List requirements
### Installation
step-by-step commands
### Usage
example usage
## 📁 Project Structure
directory/ ├── src/ ├── tests/ └── docs/
## 🧪 Testing
How to run tests.
## 🤝 Contributing
Guidelines for contributions.
## 📄 License
License information.
## 👤 Author
Contact info and links.
Instructions
When the user provides project details:
- Generate a complete, well-formatted
README.md - Use emojis tastefully for section headers
- Include code blocks for all commands
- Add placeholder comments where screenshots go
- Make it scannable with clear hierarchy
- Include badges if relevant info is provided
README Structure
A great README is the project's storefront. Someone landing on it should understand in 60 seconds: what it does, why they'd want it, and how to get started. For a CLI tool: emphasize installation and command reference. For a library: emphasize API docs and code examples. For a web app: setup, environment variables, and deployment. For open Always include: project description, installation steps, basic usage with real code examples, and a way to get help.
Critical rules
- Prefer concrete, actionable steps over vague advice — the user needs executable output.
- Ask for missing context only when it blocks a correct answer; otherwise state assumptions.
- Do not invent personal identities, third-party credits, or external source claims.
Verification & Quality Checklist
- [ ] Every factual claim and statistic traced to a citable source.
- [ ] Reading level and terminology matched to the stated audience.
- [ ] Length and formatting fit the destination channel's limits.
- [ ] One clear call to action, placed where the reader will still be reading.
Anti-Patterns & Constraints
- NEVER invent statistics, quotes, or sources.
- NEVER present an unverified figure as sourced.
- NEVER bury the central point below preamble the reader will not reach.
04 同仓库更多 Skills
workflow-optimizer
Moved to workflow-mapping in skills-agents. Removed in v4.1.
webhooks
Build webhook receivers with signature verification, idempotency, retries and dead letter queues. Use when implementing, verifying, or signing incoming/outgoing webhooks.
webhook-handler-builder
Moved to webhooks in skills-developer. Removed in v4.1.
voice-ai-integration-engineer
Moved to speech-pipelines in skills-developer. Removed in v4.1.
typescript-migrator
Moved to port-code in skills-developer. Removed in v4.1.
trigger-dev
Moved to trigger-dev in skills-agents. Removed in v4.1.