This skill generates curated, high-quality reference lists for textbooks with 10 references per chapter. References prioritize Wikipedia for reliability, include detailed relevance descriptions, and are stored in separate references.md files for token efficiency. Use this skill when working with intelligent textbooks that need academic references.
Version: 1.0
Generate high-quality, curated reference lists for educational textbooks. Each chapter receives exactly 10 references, prioritizing Wikipedia articles first for reliability, then crediting the specific textbook authors who pioneered clear or innovative ways of teaching the chapter's concepts, followed by authoritative online resources. References are never just a list of Wikipedia links — the textbook slots exist specifically to give credit to the authors behind influential explanations, analogies, or pedagogical techniques (e.g., a particularly intuitive derivation, a widely-copied diagram, a teaching analogy that became standard). References are stored in separate references.md files for token-efficient maintenance by AI agents.
Use this skill when:
Every chapter receives exactly 10 high-quality references:
Wikipedia links are placed first because they:
References are stored in separate references.md files (not inline in chapters) for:
**/references.md for bulk updatesRead the /docs/course-description.md file to determine:
Locate all chapter directories:
# Find chapter folders
ls docs/chapters/
For each chapter, read the chapter index.md to understand:
For each chapter, create exactly 10 references following this priority:
Positions 1-3: Wikipedia Articles
Find the most relevant Wikipedia articles for the chapter's main concepts:
1. [Concept Name](https://en.wikipedia.org/wiki/Concept_Name) - Wikipedia - Description of article content and relevance to chapter.
Positions 4-5: Textbooks Crediting Innovative Authors (No URL)
These two slots exist to give explicit credit to authors, not just to cite a source. For each chapter's key concepts, identify the textbook author(s) most associated with an innovative, intuitive, or influential way of teaching that concept — a distinctive analogy, derivation, notation, worked example, or diagram that other authors have since adopted or that students consistently find clarifying. Search for who "originated" or is "best known for" the chapter's core explanation before defaulting to a generic well-known textbook. Reference these textbooks without URLs (which often break):
4. Textbook Title (Edition) - Author Name - Publisher - Names the specific innovation (analogy, derivation, notation, example) this author is known for and why it makes the concept easier to grasp.
Positions 6-10: Online Resources
Verified online tutorials, courses, and educational sites:
6. [Resource Title](https://verified-url.com/path) - Source Name - Description of content and specific relevance to chapter topics.
For references 6-10, verify each URL:
WebFetch(url=reference_url, prompt="Is this page accessible? What is the main topic?")
Preferred sources (stable, educational):
Create a references.md file in each chapter directory:
File location: docs/chapters/XX-chapter-name/references.md
File format:
# References: [Chapter Title]
1. [Wikipedia Article](https://en.wikipedia.org/wiki/Topic) - Wikipedia - Comprehensive overview of [topic] including [specific aspects relevant to chapter].
2. [Wikipedia Article 2](https://en.wikipedia.org/wiki/Topic2) - Wikipedia - Detailed explanation of [concept] with [relevant details].
3. [Wikipedia Article 3](https://en.wikipedia.org/wiki/Topic3) - Wikipedia - Coverage of [related topic] including [applications/examples].
4. Textbook Title (Edition) - Author Name - Publisher - Author Name pioneered [specific analogy/derivation/notation] for [concept], now widely adopted because [why it clarifies the idea].
5. Textbook Title 2 - Author Name - Publisher - Credits Author Name's [specific innovative approach] to [chapter concept], noted for [what makes it distinctive/effective].
6. [Online Resource](https://verified-url.com) - Source - Tutorial on [topic] with [specific features like examples, exercises, visualizations].
7. [Online Resource 2](https://verified-url.com) - Source - [Description of content and relevance].
8. [Online Resource 3](https://verified-url.com) - Source - [Description of content and relevance].
9. [Online Resource 4](https://verified-url.com) - Source - [Description of content and relevance].
10. [Online Resource 5](https://verified-url.com) - Source - [Description of content and relevance].
Add a link at the end of each chapter's index.md:
[See Annotated References](./references.md)
Important: Replace any existing ## References section with this single link.
Nest an Annotated References: entry under each chapter in mkdocs.yml,
following the canonical nav-editing rules (read-before-write, serialize
edits, Content: label for the chapter page) in
$BK_HOME/skills/book-installer/references/mkdocs-nav-editing.md:
- 1. Chapter Name:
- Content: chapters/01-chapter-folder/index.md
- Quiz: chapters/01-chapter-folder/quiz.md
- Annotated References: chapters/01-chapter-folder/references.md
Each reference description should:
Good example:
1. [Karnaugh map](https://en.wikipedia.org/wiki/Karnaugh_map) - Wikipedia - Detailed explanation of K-map theory, grouping rules, and don't-care conditions. Essential foundation for the simplification techniques covered in this chapter.
Bad example:
1. [Karnaugh map](https://en.wikipedia.org/wiki/Karnaugh_map) - Wikipedia - About K-maps.
Choose Wikipedia articles that:
Reference textbooks whose author:
If no author stands out as the originator of a distinctive teaching approach, choose the textbook most often praised (in reviews, syllabi, or educator discussion) for making the concept unusually clear, and say so explicitly in the description rather than defaulting to a generic "authoritative textbook" citation.
Choose online resources that:
Before finalizing references, ensure:
docs/chapters/
├── 01-chapter-name/
│ ├── index.md # Ends with: [See Annotated References](./references.md)
│ ├── quiz.md
│ └── references.md # 10 curated references
├── 02-chapter-name/
│ ├── index.md
│ ├── quiz.md
│ └── references.md
...
| Task | Inline References | Separate Files | |------|------------------|----------------| | Read one chapter's refs | ~6,000 tokens | ~200 tokens | | Update all 15 chapters | ~90,000 tokens | ~3,000 tokens | | Batch reference check | Not feasible | Glob + process |
After generating references:
mkdocs serveThis skill uses web-based verification tools built into Claude Code:
No additional scripts or assets are required for this skill.
npx skills add dmccreary/reference-generator下载完整 Skill 目录，包含 SKILL.md 及所有相关文件
Category:science-education