book-skill-creator

Book Skill Creator - Skill Factory

Task Objective

• This Skill is used to: analyze technical documentation and websites, extract technical features through iterative learning, and generate skill decomposition plans
• Core Capabilities：
  • Website content reading (WebFetch/Read)
  • Technical feature analysis and knowledge planning
  • Iterative learning (search supplementation)
  • Skill family planning and child skill generation
  • Overall packaging and publishing of skill families
• Skill Family Concept：
  • A Skill Family is a collection of multiple related skills centered around the same technology stack
  • For example: Vue Skill Family = vue-skills (parent skill) + vue-core-skill + vue-router-skill + vue-pinia-skill (child skills)
  • A skill family itself is also a skill and has its own independent SKILL.md
  • Child skills can be used independently and can also depend on the skill family
• Trigger Conditions：
  • A technical website URL is provided and a skill family needs to be analyzed and generated
  • Generate a skill family from large documentation/technical books
  • Generate related skill families from specification documents

Core Workflow

Mode A: Intelligent Website Analysis

网站 URL → 内容读取 → 技术特点分析 → 知识规划 → 迭代学习 → 技能族规划 → 母技能生成 → 子技能生成 → 打包发布

Detailed Process: see references/web-analysis-flow.md

Mode B: Document Analysis

文档 → 解析 → 搜索补充 → 模块识别 → 技能族规划 → 母技能生成 → 子技能生成 → 打包发布

Detailed Process: see references/document-analysis-flow.md

Skill Family Creation Process (New)

When a skill family needs to be created, both the parent skill and child skills need to be created at the same time:

技能族规划 → 母技能创建 → 子技能创建 → 技能族打包

Detailed Process: see references/skill-family-flow.md

Operating Steps

Mode A: Intelligent Website Analysis Process

Detailed Steps: see references/web-analysis-flow.md

Core Step Overview：

1. Website content reading - Obtain the URL, read the content, and extract technical features
2. Knowledge planning - Analyze gaps and generate a priority list
3. Iterative learning - Supplement with search, evaluate completeness, and learn in a loop
4. Skill family planning - Identify modules and plan the structure of parent and child skills

Mode B: Document Analysis Process

Detailed Steps: see references/document-analysis-flow.md

Core Step Overview：

1. Document parsing - Read the document and identify modules
2. Search supplementation - Search for best practices
3. Skill family planning - Generate planning for parent and child skills
4. Parent skill creation - Create the skill family parent skill
5. Child skill creation - Create child skills (can be parallelized)
6. Packaging and publishing - Overall packaging and publishing of the skill family

Skill Family Creation Process

Detailed Steps: see references/skill-family-flow.md

Core Step Overview：

1. Skill family planning - Determine the skill family structure and child skill list
2. Parent skill creation - Create the skill family parent skill (vue-skills)
3. Child skill creation - Create sub-skills (vue-core-skill, etc.)
4. Package and publish - Package the entire skill family into one directory

Skill family generation and packaging

Both modes support skill family generation and packaging:

• Parent skill generation: Create the parent skill of a skill family (such as vue-skills)
• Sub-skill generation: Create sub-skills (such as vue-core-skill)
• Skill family packaging: Package the parent skill and sub-skills into one directory

Detailed process: See references/skill-family-flow.md

Resource index

Resource	Path	Purpose
Skill specification	references/skill-specs.md	SKILL.md writing specification
Framework guide	references/frameworks-guide.md	Common framework categories and use cases
Best practices	references/best-practices.md	Solution categories and solutions
Skill family process	references/skill-family-flow.md	Complete process for creating a skill family
Website analysis guide	references/web-analysis-guide.md	Complete guide to the intelligent website analysis mode
API skill template	assets/skill-templates/api-skill.md	API-type skill template
Data processing template	assets/skill-templates/data-process.md	Data processing-type skill template
Workflow template	assets/skill-templates/workflow.md	Workflow-type skill template

Notes

Analysis and planning phase

• Module division principles: High cohesion, low coupling, each module has a single responsibility
• Dependency identification: Accurately identify dependencies between modules and avoid circular dependencies
• Complexity assessment: Reasonably assess the complexity of each skill to facilitate resource allocation

Parallel generation phase

• Independent execution: Each skill generation should be independent to avoid mutual interference
• Resource sharing: Shared concepts and code are placed in the shared/ directory
• Progress tracking: Track the generation progress of each skill in real time

Quality verification phase

• Independent verification: Each skill is generated first and then independently verified
• Consistency check: Finally, uniformly check consistency among skills
• Issue fixing: Fix issues promptly when found and verify again

Usage examples

Example 1: Intelligent website analysis mode - Create a Vue skill family

Input：https://vuejs.org

Output: Vue skill family

vue-skills/                          # 母技能
├── SKILL.md                        # 技能族定义
├── references/
│   └── overview.md                 # 技能族概述
└── skills/                         # 子技能目录
    ├── vue-core-skill/             # 核心技能
    ├── vue-composition-api-skill/  # 组合式 API 技能
    ├── vue-router-skill/           # 路由技能
    ├── vue-pinia-skill/           # 状态管理技能
    └── vue-testing-skill/          # 测试技能

Detailed process: See references/skill-family-flow.md

Example 2: Document analysis mode - Create a React skill family

Input: React official documentation

Output: React skill family

react-skills/                        # 母技能
├── SKILL.md                        # 技能族定义
├── references/
│   └── overview.md                 # 技能族概述
└── skills/                         # 子技能目录
    ├── react-core-skill/          # 核心技能
    ├── react-hooks-skill/         # Hooks 技能
    ├── react-router-skill/         # 路由技能
    └── react-testing-skill/        # 测试技能

Detailed process: See references/skill-family-flow.md

Quality thresholds

Mode A: Intelligent website analysis

• Website URL accessibility verification passed
• Core functionality extraction complete (at least 3)
• Key concept extraction complete (at least 5)
• Information completeness reaches 80% or above
• Skill splitting is reasonable and dependencies are correct

Mode B: Document analysis

• Complete document structure parsing
• Accurate technical module identification
• Reasonable skill decomposition
• Each skill independently verified

Detailed inspection standards: see references/skill-standards.md

Framework quick reference

Supports analysis of the following technology stacks:

• Web frameworks：React, Vue, Angular, Svelte, FastAPI, Express, Django, Flask
• Backend languages：Go, Python, Rust, Java, Node.js, TypeScript
• Databases：PostgreSQL, MongoDB, Redis, MySQL, SQLite
• AI/ML frameworks：PyTorch, TensorFlow, Scikit-learn, LangChain

Detailed usage guide: see references/frameworks-guide.md