メニュー
Generates a LinkedIn post announcing an intelligent textbook milestone by pulling book metrics, chapter count, and key statistics. Use when announcing textbook completion or major content milestones on social media.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Generates illustrated graphic novel narratives about scientists, mathematicians, and historical figures for intelligent textbooks, with image prompts for each panel. Use when adding historical-figure or case-study stories to a textbook's Stories section.
Installs and configures intelligent-textbook infrastructure - scaffold a brand-new MkDocs Material textbook (init textbook), install any of 40 features (math, mascot, learning graph viewer, Google Analytics GA4, custom 404, kanban board), and generate book metrics. Routes to the appropriate installation guide.
Creates interactive educational MicroSims, routing to the best-matched generator - p5.js, Chart.js, Plotly, Mermaid, vis-network, timelines, maps, Venn, causal-loop/feedback-loop diagrams (CLD), concept-classifier sorting quizzes, infographic overlays with callout labels, and Docker Python labs (runnable code blocks). Generates complete MicroSim packages with HTML, JavaScript, CSS, documentation, and metadata.
Generates a comprehensive learning graph from a course description, including 200 concepts with dependencies, taxonomy categorization, and quality validation reports. Use this when the user wants to create a structured knowledge graph for educational content.
Wires Google Analytics 4 into an MkDocs Material site — creates a GA4 property, writes the Measurement ID into mkdocs.yml, verifies the tag, and deploys. Use when adding analytics to a textbook for the first time.
Generates detailed chapter content for an intelligent textbook — text, diagrams, MicroSims, and exercises at the appropriate Bloom's level. Use when a chapter's index.md exists with title, summary, and concept list.
| name | linkedin-announcement-generator |
| description | Generates a LinkedIn post announcing an intelligent textbook milestone by pulling book metrics, chapter count, and key statistics. Use when announcing textbook completion or major content milestones on social media. |
| license | Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) |
| model | sonnet |
This skill automates the creation of professional LinkedIn announcements for intelligent textbooks. It analyzes book metrics from the docs/learning-graph/ directory, gathers statistics about chapters, concepts, and educational resources, and generates engaging announcement text with relevant hashtags and links to the published site.
The announcements are designed to highlight the scope and completeness of the textbook, showcase its educational features, and attract educators, students, and learning professionals to the content.
Use this skill when:
The intelligent textbook project should have:
docs/learning-graph/book-metrics.json file containing the canonical
textbook statistics (produced by the book-metrics tool). If it is missing,
generate it first with bk-generate-book-metrics (or the
python3 "$BK_HOME/src/book-metrics/book-metrics.py" docs fallback).mkdocs.yml file with site_name, site_url, and site_descriptiondocs/learning-graph/chapter-metrics.md for chapter-level detailsdocs/course-description.md for audience and topic informationExtract key information from the project configuration:
Read mkdocs.yml to get:
site_name - Title of the textbooksite_url - Live site URL (typically GitHub Pages)site_description - Brief description of the textbookrepo_url - GitHub repository URLRead docs/course-description.md (if it exists) to get:
Example extraction:
site_name: 'Geometry for High School Students'
site_url: 'https://username.github.io/geometry-course/'
site_description: 'An interactive geometry textbook with MicroSims and quizzes'
Read the canonical metrics file docs/learning-graph/book-metrics.json — do
not parse the human-readable book-metrics.md table (brittle) or recount
content yourself. This is the same source the README and case-study skills use,
so the numbers stay consistent across every artifact.
python3 - <<'PY'
import json, pathlib, sys
p = pathlib.Path("docs/learning-graph/book-metrics.json")
if not p.exists():
sys.exit("book-metrics.json missing — run bk-generate-book-metrics first")
m = json.loads(p.read_text())["metrics"]
print(json.dumps(m, indent=2))
PY
Core Metrics (keys in the metrics object):
chapters — Number of chaptersconcepts — Number of concepts in the learning graphglossaryTerms — Number of glossary termsfaqs — Number of FAQ questionsquizQuestions — Number of quiz questionsdiagrams — Number of diagramsequations — Number of equationsmicrosims — Number of MicroSims (interactive simulations)words — Total word countlinks — Number of hyperlinksequivalentPages — Equivalent printed pagesdevelopmentStage — Author-declared publication stageIf book-metrics.json does not exist, regenerate it with
bk-generate-book-metrics before reading. The format is defined by
src/book-metrics/book-metrics.schema.json.
Handle missing metrics gracefully:
Calculate the completion status based on metrics:
Indicators of completeness:
Status categories:
Choose appropriate language for the announcement based on status.
Create a LinkedIn post with the following components:
1. Opening Hook (1-2 sentences)
Start with an attention-grabbing statement that:
Examples:
2. Content Description (2-3 sentences)
Explain what the textbook covers and its unique features:
Example:
This intelligent textbook on [TOPIC] is designed for [AUDIENCE]. Built using MkDocs Material and AI-assisted content generation, it incorporates learning graphs, concept dependencies, and interactive MicroSims to make [TOPIC] accessible and engaging.
3. Key Metrics (bulleted list)
Present impressive statistics to demonstrate scope:
📊 By the numbers:
• [X] chapters covering [TOPIC AREAS]
• [Y] concepts in the learning graph
• [Z] interactive MicroSims (p5.js simulations)
• [Q] quiz questions for self-assessment
• [G] glossary terms with ISO 11179-compliant definitions
• [W] total words (~[P] equivalent printed pages)
Formatting tips:
4. Technology and AI Disclosure (1-2 sentences)
Be transparent about AI involvement and technology:
Generated using Claude AI skills and the intelligent textbook framework, this open-source project demonstrates how AI can augment educational content creation while maintaining quality and pedagogical rigor.
5. Call to Action (1 sentence)
Direct readers to the site — but never put the URL in the post body.
The "link in the first comment" rule: research shows LinkedIn's algorithm significantly reduces the reach of posts that contain external links in the post body. Instead, tell readers the link is in the comments, and provide the URL as a separate first-comment text the user pastes immediately after publishing:
🔗 Link to the full textbook is in the first comment below! 👇
Always generate the first-comment text along with the post:
Explore the full textbook here: [SITE_URL]
This rule applies to ALL external links (site URL, GitHub repo, blog posts) — none of them belong in the post body.
6. Hashtags (8-15 tags)
Include relevant hashtags for discoverability:
Standard hashtags:
#AI / #ArtificialIntelligence#GenAI / #GenerativeAI#Education / #EdTech / #EducationalTechnology#OpenEducation / #OER (Open Educational Resources)#ELearning / #OnlineLearningContent-specific hashtags:
#Textbook / #InteractiveTextbook#MicroSims / #Simulations#Visualizations / #DataViz#Diagrams / #Infographics#Quizzes / #AssessmentTechnology-specific hashtags:
#MkDocs / #MaterialDesign#p5js / #JavaScript#Python#ClaudeAI / #AnthropicClaudeDomain-specific hashtags:
Add 2-4 hashtags specific to the subject matter:
#Mathematics, #Geometry, #Calculus, #Algebra#Physics, #Chemistry, #Biology#Programming, #ComputerScience, #DataScience#History, #WorldHistory, #AmericanHistoryProfessional/Academic hashtags:
#LMS / #LearningManagementSystem#CurriculumDesign#InstructionalDesign#STEM / #STEMeducation#HigherEd / #K12EducationTotal hashtag count: Aim for 10-15 hashtags for optimal reach.
LinkedIn voice characteristics:
Writing best practices:
Avoid:
Create three variations of the announcement:
Variation 1: Detailed (Full Length)
Variation 2: Medium (Standard Length)
Variation 3: Concise (Short Form)
Provide all three variations so the user can choose based on their preference.
If available, include:
Screenshot or cover image suggestion:
📸 Suggested visual: Screenshot of the learning graph visualization or the textbook home page
Notable features callout:
If the textbook has unique elements, highlight them:
Collaboration invitation:
If seeking contributors:
Related links:
If applicable (all external links go in the first comment, never the post body):
Present the LinkedIn announcement(s) in a clear, copy-paste ready format:
## LinkedIn Announcement - Full Version
[Paste-ready text here]
---
## LinkedIn Announcement - Medium Version
[Paste-ready text here]
---
## LinkedIn Announcement - Concise Version
[Paste-ready text here]
---
## First Comment (paste immediately after publishing)
[Text containing the site URL — external links go here, never in the post body]
---
## Suggested Enhancements
**Visual:** [Description of recommended image/screenshot]
**Timing:** Best posted [weekday, time recommendation]
**Engagement Tips:**
- Tag relevant individuals or organizations if appropriate
- Respond to comments within first 2 hours for algorithm boost
- Consider posting during peak LinkedIn hours (Tuesday-Thursday, 8-10am or 12-2pm)
Before finalizing, check that the announcement:
Output the finalized announcement text(s) ready for the user to:
Inform the user:
✅ LinkedIn announcement generated successfully!
Three variations provided (full, medium, concise) - choose the one that fits your style.
**Next steps:**
1. Copy your preferred version
2. Paste into LinkedIn post composer
3. Add a screenshot of your textbook (optional but recommended)
4. Review and post!
5. Immediately paste the provided first-comment text (with the link) as the first comment
Remember: keep the link OUT of the post body — LinkedIn reduces reach for posts with external links. The link goes in the first comment.
Pro tip: LinkedIn posts with images get 2x more engagement. Consider adding a screenshot of your learning graph or textbook homepage.
🎓 Excited to share a new open educational resource: an interactive textbook on Geometry designed for high school students!
This intelligent textbook combines AI-assisted content generation with proven educational frameworks. Built using MkDocs Material, it incorporates learning graphs showing concept dependencies, interactive MicroSims using p5.js, and comprehensive assessment tools to make geometry accessible and engaging.
📊 By the numbers:
• 13 chapters covering points, lines, angles, triangles, polygons, circles, and 3D geometry
• 200 concepts organized in a dependency graph
• 5 interactive MicroSims (p5.js simulations)
• 10 quiz questions for self-assessment
• 22 glossary terms with precise definitions
• 225,000+ words (~900 equivalent printed pages)
Generated using Claude AI skills and the intelligent textbook framework, this open-source project demonstrates how AI can augment educational content creation while maintaining pedagogical quality and rigor.
All content follows Bloom's Taxonomy (2001) for learning outcomes and includes detailed explanations, worked examples, and practice exercises.
🔗 Link to the full textbook is in the first comment below! 👇
#AI #GenAI #GenerativeAI #Education #EdTech #OpenEducation #OER #ELearning #Textbook #InteractiveTextbook #MicroSims #Visualizations #Quizzes #Geometry #Mathematics #MkDocs #ClaudeAI #LMS #CurriculumDesign #STEMeducation
📚 Just published: An AI-generated interactive textbook on Geometry for high school students!
This intelligent textbook uses MkDocs Material, learning graphs, and interactive p5.js MicroSims to make geometry engaging and accessible.
Key features:
• 13 comprehensive chapters
• 200 concepts with dependency mapping
• 5 interactive simulations
• 225,000+ words of content
• Open source and freely available
Built using Claude AI and the intelligent textbook framework - demonstrating how AI can enhance educational content while maintaining quality.
Link in the first comment below! 👇
#AI #GenAI #Education #EdTech #OpenEducation #Textbook #MicroSims #Geometry #Mathematics #ClaudeAI #STEMeducation
🎓 New open educational resource: Interactive Geometry textbook for high school!
✨ 13 chapters | 200 concepts | 5 MicroSims | 225K words
AI-generated using Claude and MkDocs Material. Free and open source.
📖 Link in the first comment!
#Education #EdTech #Geometry #AI #OpenEducation #Textbook
Paste immediately after publishing (external links live here, not in the post):
Explore the full textbook here: https://dmccreary.github.io/claude-skills/
GitHub repo: https://github.com/dmccreary/claude-skills
The skill can be customized to:
1. Adjust tone:
2. Target different audiences:
3. Emphasize different aspects:
4. Include additional context:
Metrics come straight from the canonical book-metrics.json — no markdown
parsing required. A small helper only needs to load the JSON and the site
config:
scripts/linkedin-metrics-extractor.py
#!/usr/bin/env python3
"""Load canonical metrics + site config for LinkedIn announcements."""
import json
import yaml
def load_book_metrics(metrics_json="docs/learning-graph/book-metrics.json"):
"""Return the `metrics` dict from the canonical book-metrics.json."""
with open(metrics_json, encoding="utf-8") as f:
return json.load(f)["metrics"]
def extract_site_config(mkdocs_file):
"""Parse mkdocs.yml and return site metadata (name, url, description)."""
# Implementation: Load YAML and extract site_name, site_url, etc.
pass
def format_number(n):
"""Format numbers for readability (e.g., 225182 -> 225,000)."""
# Implementation: Round and format large numbers
pass
# Usage:
# python linkedin-metrics-extractor.py docs/learning-graph/book-metrics.json mkdocs.yml
A high-quality LinkedIn announcement should:
Issue: Metrics not found in book-metrics.json
Solution: Generate the metrics first — run bk-generate-book-metrics (or invoke book-installer and request the book-metrics guide) to create the metrics file
Issue: Site URL not available
Solution: Ask user for the deployed site URL or GitHub Pages link
Issue: Announcement too long (> 3000 characters)
Solution: Use the medium or concise variation instead
Issue: Not sure which hashtags to use
Solution: Focus on the subject domain (e.g., #Mathematics for math textbooks) and general education tags
bk-generate-book-metrics - Generates the metrics file used by this skill