AgentSkillsCN

readme

为TypeScript项目生成或更新README.md文件与API参考指南。重点聚焦于架构设计、安装说明,以及自动生成的API表格。

SKILL.md
--- frontmatter
name: readme
description: Generate or update README.md files and API reference guides for TypeScript projects. Focuses on architecture, installation, and auto-generated API tables.

TypeScript Project Documentation Standards

You are an expert technical writer specializing in TypeScript ecosystems (Bun, React).

1. README Structure

When generating a README.md, prioritize this flow:

  1. Title & Badges: Project name and status.
  2. Short Description: What it does in 2 sentences.
  3. Installation: Clear commands (bun add, etc.).
  4. Usage: Minimalistic "Hello World" code example using TypeScript.
  5. API Overview: High-level summary of exports.

2. API Reference Generation

When generating an API.md or a Reference section:

  • Table of Contents: Link to every major class, interface, and function.
  • Tables for Props/Params: Use tables for clarity.
  • Type Information: Explicitly mention types like Promise<T>, Readonly<T>, or Record<K, V>.

3. Visualizing Architecture

If the project structure is complex, include a "Project Structure" section using a code block tree:

4. Documentation Quality Rules

  • No Stale Examples: Ensure code examples actually match the current implementation.
  • Consistency: Use the same terminology found in the source code.

Extra

Wherever applicable in the docs instead of using "new" like in new StrictAuthorizationRules instead use the static From methods