skill-from-notebook

from gbsoss/skill-from-masters

Stand on the shoulders of giants — Create AI skills built on proven methodologies from domain experts.

729 stars81 forksUpdated Jan 24, 2026
npx skills add https://github.com/gbsoss/skill-from-masters --skill skill-from-notebook

SKILL.md

Skill from Notebook

Extract actionable methodologies from learning materials (documents, articles, videos) or quality examples (blog posts, designs, code) to generate reusable Skills.

Core Philosophy: NotebookLM helps you understand. This skill helps you do.

When to Use

When users want to turn knowledge into executable skills:

  • "I just read this article about code review, help me create a skill from it"
  • "Here's a great technical blog post, extract the writing methodology"
  • "Turn this PDF guide into a skill I can reuse"
  • "Learn from this example and create a skill to produce similar output"

Supported Input Types

TypeHow to Process
Local filesPDF, Word, Markdown - Read directly
Web URLWebFetch to extract content
YouTubeUse yt-dlp for subtitles, Whisper if unavailable
NotebookLM linkBrowser automation to extract notes/summaries
Example/OutputReverse engineer the methodology

Step 0: Identify Input Type

Critical first step - Determine which processing path to use:

User Input
    │
    ├─ Has teaching intent? ("how to", "steps", "guide")
    │   └─ YES → Path A: Methodology Document
    │
    ├─ Is a finished work? (article, design, code, proposal)
    │   └─ YES → Path B: Example (Reverse Engineering)
    │
    └─ Neither? → Tell user this content is not suitable

Path A indicators (Methodology Document):

  • Contains words like "how to", "steps", "method", "guide"
  • Has numbered lists or step sequences
  • Written with teaching intent
  • Describes "what to do"

Path B indicators (Example/Output):

  • Is a complete work/artifact
  • No teaching intent
  • Is "the thing itself" rather than "how to make the thing"
  • Examples: a well-written blog post, a polished proposal, a code project

Path A: Extract from Methodology Document

A1: Validate Document Suitability

Check if the document is suitable for skill generation (must meet at least 2):

  • Has clear goal/outcome
  • Has repeatable steps/process
  • Has quality criteria
  • Has context/scenario description

If not suitable: Tell user honestly and explain why.

A2: Identify Skill Type

TypeCharacteristicsExamples
How-toClear step sequence, input→outputDeploy Docker, Configure CI/CD
DecisionConditions, trade-offs, choicesChoose database, Select framework
FrameworkMental model, analysis dimensionsSWOT, 5W1H, First Principles
ChecklistVerification list, pass/fail criteriaCode review checklist, Launch checklist

A3: Extract Structure by Type

For How-to:

  • Prerequisites
  • Step sequence (with expected output per step)
  • Final expected result
  • Common errors

For Decision:

  • Decision factors
  • Options with pros/cons
  • Decision tree/flowchart
  • Recommended default

For Framework:

  • Core concepts
  • Analysis dimensions
  • Application method
  • Limitations

For Checklist:

  • Check items with criteria
  • Priority levels
  • Commonly missed items

A4: Generate Skill

Use this template:

## Applicable Scenarios
[When to use this skill]

## Prerequisites
- [What's needed before starting]

## Steps
1. [Step 1] - [Expected outcome]
2. [Step 2] - [Expected outcome]
...

## Quality Checkpoints
- [ ] [Checkpoint 1]
- [ ] [Checkpoint 2]

## Common Pitfalls
- [Pitfall 1]: [How to avoid]

## Source
- Document: [name/URL]
- Extracted: [timestamp]

Path B: Reverse Engineer from Example

When input is a finished work (not a tutorial), reverse engineer the methodology.

B1: Identify Output Type

What kind of artifact is this?

  • Technical blog post
  • Product proposal/PRD
  • Academic paper
  • Code architecture
  • Design document
  • Other: [specify]

B2: Analyze Structure

Break down the example:

Structure Analysis:
├── [Part 1]: [Function] - [Proportion %]
├── [Part 2]: [Function] - [Proportion %]
├── [Part 3]: [Function] - [Proportion %]
└── [Part N]: [Function] - [Proportion %]

Questions to answer:

  • How many parts does it have?
  • What's the function of each part?
  • What's the order and proportion?

B3: Extract Quality Characteristics

What makes this example good?

DimensionQuestions
StructureHow is content organized?
StyleTone, word choice, expression?
TechniqueWhat methods make it effective?
LogicHow does information flow?
DetailsSmall but important touches?

B4: Reverse Engineer the Process

Deduce: To create this output, what steps are needed?

## Deduced Production Steps
1. [Step 1]: [What to do] - [Key point]
2. [Step 2]: [What to do] - [Key point]
...

## Key Decisions
- [Decision 1]: [Options] - [This example chose X because...]

## Reusable Techniques
- [Technique 1]: [How to apply]
- [Technique 2]: [How to apply]

B5: Generate Skill

Use this template for reverse-engineered skills:

...

Read full content

Repository Stats

Stars729
Forks81
LicenseMIT License