Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Fengshao1227/Gen Docs — measured AI agent skill | DecimalAI

fengshao1227/gen-docs

NewSkillScoreMaintained

文档生成器。自动分析模块结构，生成 README.md 和 DESIGN.md 骨架。当用户提到生成文档、创建README、创建DESIGN、文档骨架、文档模板时使用。在新建模块开始时自动触发。

by fengshao1227

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Doc Ops pack

decimalai skills pull fengshao1227-gen-docs

Get this skill — curl · raw file

curl -fsSL https://app.decimal.ai/s/fengshao1227-gen-docs/SKILL.md

Raw file: /s/fengshao1227-gen-docs/SKILL.md ↗ · machine-readable summary at /s/fengshao1227-gen-docs.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 22h ago

Yes — +55% lift-13% tokens0% turns95% of whole cases pass with skill (21/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	-37%	0%
case-03	✗→✓	▲ Improved	462%	0%
case-07	✗→✓	▲ Improved	-1%	0%
case-08	✗→✓	▲ Improved	-33%	0%
case-10	✗→✓	▲ Improved	-16%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

fengshao1227 / ccg-workflow

templates/skills/tools/gen-docs/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1Bundled 1 file · scripts

Skill contents

scripts/

SKILL.md

📝 造典关卡 · 文档生成器

核心原则

无文档不成模块
文档是模块的身份证
没有身份证的模块不允许上线

自动生成

运行文档生成脚本（跨平台）：

bash
# 在 skill 目录下运行
node scripts/doc_generator.js <模块路径>
node scripts/doc_generator.js <模块路径> --force  # 强制覆盖已存在的文档
node scripts/doc_generator.js <模块路径> --json   # JSON 输出

生成内容

README.md 骨架

自动生成的 README.md 包含：

模块名称 — 从目录名提取
描述 — 从代码文档字符串提取（如有）
特性列表 — 待填充
依赖 — 从 requirements.txt/pyproject.toml 提取
使用方法 — 基础模板
API 概览 — 从代码提取类和函数列表
目录结构 — 自动扫描生成

DESIGN.md 骨架

自动生成的 DESIGN.md 包含：

设计概述 — 目标与非目标模板
架构设计 — 架构图占位符
核心组件 — 从代码提取类列表
设计决策 — 决策记录表格模板
技术选型 — 自动检测语言和依赖
权衡取舍 — 已知限制和技术债务模板
安全考量 — 威胁模型和安全措施模板
变更历史 — 初始版本记录

智能分析

支持的语言

| 语言 | 分析能力 | |------|----------| | Python | 类、函数、文档字符串、依赖 | | Go | 目录结构、依赖 | | TypeScript | 目录结构、依赖 | | Rust | 目录结构、依赖 | | 其他 | 基础目录结构 |

提取的信息

模块名称（目录名）
主要编程语言
代码文件列表
类和函数定义（Python）
文档字符串（Python）
依赖列表
入口点文件

自动触发时机

| 场景 | 触发条件 | |------|----------| | 新建模块 | 模块创建开始时 | | 缺失文档 | 检测到模块缺少文档时 |

使用流程

1. 运行 doc_generator.js 生成骨架
2. 填充 TODO 标记的内容
3. 补充设计决策和理由
4. 添加使用示例
5. 运行 /verify-module 校验完整性

生成后检查清单

README.md

] 填充模块描述
] 补充特性列表
] 添加使用示例
] 确认依赖完整

DESIGN.md

] 明确设计目标
] 记录设计决策
] 说明技术选型理由
] 列出已知限制

Want to see if fengshao1227/gen-docs would activate on your phrasing? Try it before you install — no LLM call, no signup.

Other measured skills in the registry, with their headline benchmark lift.