skill-creator

lyndonkl 的头像作者 lyndonkl

当用户拥有包含理论知识或框架的文档(PDF、markdown、书籍笔记、研究论文、方法指南)并希望将其转化为可操作的可重用技能时使用。当用户提及"从本文档创建技能"、"将其转化为技能"、"从本文件提取技能",或者分析包含可转化为未来使用行动的方法、框架、流程或系统方法的文档时调用。

📖 中文导读:当用户拥有包含理论知识或框架的文档(PDF、markdown、书籍笔记、研究论文、方法指南)并希望将其转化为可操作的可重用技能时使用。当用户提及"从本文档创建技能"、"将其转化为技能"、"从本文件提取技能",或者分析包含可转化为未来使用行动的方法、框架、流程或系统方法的文档时调用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: skill-creator description: Use when the user has a document (PDF, markdown, book notes, research paper, methodology guide) containing theoretical knowledge or frameworks and wants to convert it into an actionable, reusable skill. Invoke when the user mentions "create a skill from this document", "turn this into a skill", "extract a skill from this file", or when analyzing documents with methodologies, frameworks, processes, or systematic approaches that could be made actionable for future use.

Skill Creator

Table of Contents


Read This First

What This Skill Does

This skill helps you transform documents containing theoretical knowledge into actionable, reusable skills. It applies systematic reading methodology from "How to Read a Book" by Mortimer Adler to extract, analyze, and structure knowledge from documents.

The Process Overview

The skill follows a six-step progressive reading approach:

  1. Inspectional Reading - Quick overview to understand structure and determine if the document contains skill-worthy material
  2. Structural Analysis - Deep understanding of what the document is about and how it's organized
  3. Component Extraction - Systematic extraction of actionable components from the content
  4. Synthesis and Application - Critical evaluation and transformation of theory into practical application
  5. Skill Construction - Building the actual skill files (SKILL.md, resources, rubric)
  6. Validation and Refinement - Scoring the skill quality and making improvements

Why This Approach Works

This methodology prevents common mistakes like:

  • Reading entire documents without structure (information overload)
  • Missing key concepts by not understanding the overall framework first
  • Extracting theory without identifying practical applications
  • Creating skills that can't be reused because they're too specific or too vague

Collaborative Process

This skill is always collaborative with you, the user. At decision points, you'll be presented with options and trade-offs. The final decisions always belong to you. This ensures the skill created matches your needs and mental model.


Workflow

COPY THIS CHECKLIST and work through each step:

Skill Creation Workflow
- [ ] Step 0: Initialize session workspace
- [ ] Step 1: Inspectional Reading
- [ ] Step 2: Structural Analysis
- [ ] Step 3: Component Extraction
- [ ] Step 4: Synthesis and Application
- [ ] Step 5: Skill Construction
- [ ] Step 6: Validation and Refinement

Step 0: Initialize Session Workspace

Create working directory and global context file. See resources/inspectional-reading.md#session-initialization for setup commands.

Step 1: Inspectional Reading

Skim document systematically, classify type, assess skill-worthiness. Writes to step-1-output.md. See resources/inspectional-reading.md#why-systematic-skimming for skim approach, resources/inspectional-reading.md#why-document-type-matters for classification, resources/inspectional-reading.md#why-skill-worthiness-check for assessment criteria.

Step 2: Structural Analysis

Reads global-context.md + step-1-output.md. Classify content, state unity, enumerate parts, define problems. Writes to step-2-output.md. See resources/structural-analysis.md#why-classify-content, resources/structural-analysis.md#why-state-unity, resources/structural-analysis.md#why-enumerate-parts, resources/structural-analysis.md#why-define-problems.

Step 3: Component Extraction

Reads global-context.md + step-2-output.md. Choose reading strategy, extract terms/propositions/arguments/solutions section-by-section. Writes to step-3-output.md. See resources/component-extraction.md#why-reading-strategy for strategy selection, resources/component-extraction.md#section-based-extraction for programmatic approach, resources/component-extraction.md#why-extract-terms through resources/component-extraction.md#why-extract-solutions for what to extract.

Step 4: Synthesis and Application

Reads global-context.md + step-3-output.md. Evaluate completeness, identify applications, transform to actionable steps, define triggers. Writes to step-4-output.md. See resources/synthesis-application.md#why-evaluate-completeness, resources/synthesis-application.md#why-identify-applications, resources/synthesis-application.md#why-transform-to-actions, resources/synthesis-application.md#why-define-triggers.

Step 5: Skill Construction

Reads global-context.md + step-4-output.md. Determine complexity, plan resources, create SKILL.md and resource files, create rubric. Writes to step-5-output.md. See resources/skill-construction.md#why-complexity-level, resources/skill-construction.md#why-plan-resources, resources/skill-construction.md#why-skill-md-structure, resources/skill-construction.md#why-resource-structure, resources/skill-construction.md#why-evaluation-rubric.

Step 6: Validation and Refinement

Reads global-context.md + step-5-output.md + actual skill files. Score using rubric, present analysis, refine based on user decision. Writes to step-6-output.md. See resources/evaluation-rubric.json for criteria.


Notes

  • File-Based Context: Each step writes output files to avoid context overflow
  • Global Context: All steps read global-context.md for continuity
  • Sequential Dependencies: Each step reads previous step's output
  • User Collaboration: Always present findings and get approval at decision points
  • Quality Standards: Use evaluation rubric (threshold ≥ 3.5) before delivery