Skip to content

Commit 3546de5

Browse files
GarethManningclaude
andcommitted
docs: add feedback section, curriculum-alignment domain, npx install instructions; move docs to docs/ folder
- Add Feedback & Contributions section (email, X, LinkedIn, GitHub) after opening paragraph - Add Domain 15 Curriculum Alignment to domain table; update section header to 15 Domains - Add Local (npx), Claude Code (stdio), and Remote (Vercel) subsections to Installation - Move 10 root-level doc files (ARCHITECTURE, EVIDENCE, EXCLUSIONS, etc.) to docs/ - Update relative path refs in README.md and absolute GitHub URLs in llms.txt and mcp-server/index.html Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent c5c56ff commit 3546de5

13 files changed

Lines changed: 42 additions & 11 deletions

README.md

Lines changed: 36 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,17 @@ An open-source library of 111 evidence-based pedagogical skills for curriculum d
99

1010
---
1111

12+
## Feedback & Contributions
13+
14+
I'd love to hear your thoughts. If you have suggestions, find bugs, or want to contribute:
15+
16+
- Email: gareth.manning@gmail.com
17+
- X: https://x.com/worldteacherman
18+
- LinkedIn: https://www.linkedin.com/in/gareth-manning-a404b387/
19+
- Open a Pull Request or Issue on GitHub
20+
21+
---
22+
1223
**I'm an educator — [start here](#try-it-now)**
1324
No setup required. Install the plugin and start teaching.
1425

@@ -62,9 +73,28 @@ Connect via the MCP server to access all 111 skills in any Claude conversation
6273

6374
Skills load with progressive disclosure — metadata only until a skill is actually needed.
6475

65-
### API / Programmatic Access
76+
### Local (via npx)
77+
78+
```bash
79+
npx claude-education-skills
80+
```
81+
82+
### Claude Code (stdio)
83+
84+
Add to your Claude Code config:
85+
86+
```json
87+
{
88+
"mcpServers": {
89+
"claude-education-skills": {
90+
"command": "npx",
91+
"args": ["claude-education-skills"]
92+
}
93+
}
94+
}
95+
```
6696

67-
Connect to the live MCP server:
97+
### Remote (Vercel)
6898

6999
```
70100
https://mcp-server-sigma-sooty.vercel.app/mcp
@@ -115,7 +145,7 @@ Claude returns a complete week-by-week schedule showing when to teach new conten
115145
## What Makes This Different
116146

117147
**Evidence is the filter — including knowing what to exclude.**
118-
Every skill is grounded in named research: specific authors, specific studies, specific findings. Frameworks that lack empirical support — including learning styles, VAK, and other widely-circulated but poorly-evidenced approaches — are not included. The library documents exactly what was excluded and why in [EXCLUSIONS.md](EXCLUSIONS.md). For any school or faculty trying to separate evidence from convention, that document is worth reading on its own.
148+
Every skill is grounded in named research: specific authors, specific studies, specific findings. Frameworks that lack empirical support — including learning styles, VAK, and other widely-circulated but poorly-evidenced approaches — are not included. The library documents exactly what was excluded and why in [EXCLUSIONS.md](docs/EXCLUSIONS.md). For any school or faculty trying to separate evidence from convention, that document is worth reading on its own.
119149

120150
**Evidence strength is rated transparently.**
121151

@@ -136,7 +166,7 @@ YAML schema headers, typed input and output fields, chaining metadata, and compo
136166

137167
---
138168

139-
## The 14 Domains
169+
## The 15 Domains
140170

141171
| # | Domain | Skills | Focus |
142172
|---|--------|--------|-------|
@@ -154,12 +184,13 @@ YAML schema headers, typed input and output fields, chaining metadata, and compo
154184
| 12 | **AI Learning Science** | 14 | Adaptive hints, erroneous examples, digital worked examples, spacing algorithms, AI feedback, tutoring dialogue, learning analytics, collaborative learning, cognitive tutoring, self-explanation, metacognitive monitoring, productive failure, worked example transitions, formative assessment loops |
155185
| 13 | **Montessori & Alternative Evidence-Based Approaches** | 4 | Three-part lessons, prepared environment design, mixed-age learning, uninterrupted work cycles |
156186
| 14 | **Original Frameworks** | 5 | SEEDS regenerative inquiry, developmental band systems, learning target authoring, rubric logic, self-determined project design |
187+
| 15 | **Curriculum Alignment** | 4 | Coverage audit, KUD chart authoring, developmental band translation, scope and sequence |
157188

158189
---
159190

160191
## Architecture
161192

162-
The library is Layer 1 of a three-layer system. See [ARCHITECTURE.md](ARCHITECTURE.md) for the full design.
193+
The library is Layer 1 of a three-layer system. See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full design.
163194

164195
**Layer 1 — Skill Library** (this repository, complete and available now)
165196
111 skills across 15 domains. Each skill encodes a specific, evidence-grounded instructional or curriculum design decision. Works standalone today.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)