@booklib/skills 1.3.1 → 1.3.2

package/CONTRIBUTING.md

@@ -14,7 +14,7 @@ A skill is worth adding when the source book:
 ### 1. Create the folder
 
 ```
-skill-name/
+skills/skill-name/
 ├── SKILL.md          # Required
 ├── examples/
 │   ├── before.md     # Code or artifact before applying the skill
@@ -100,7 +100,7 @@ Aim for 3–5 evals per skill covering:
 ```bash
 git checkout -b skill/book-name
 # add your skill folder
-git add skill-name/
+git add skills/skill-name/
 git commit -m "feat: add skill-name skill"
 gh pr create --title "feat: add skill-name" --body "..."
 ```

package/README.md

@@ -10,18 +10,20 @@ Each skill is a self-contained folder with a `SKILL.md` file containing instruct
 skills/
 ├── README.md
 ├── LICENSE
-├── clean-code-reviewer/          # Code review using Clean Code principles
-│   ├── SKILL.md
-│   └── evals/
-│       └── evals.json
-├── [future-skill]/
-│   ├── SKILL.md
-│   ├── scripts/                  # Executable code (Python/Bash)
-│   ├── references/               # Documentation loaded into context as needed
-│   ├── assets/                   # Templates, icons, fonts
-│   └── evals/                    # Test cases for the skill
-│       ├── evals.json
-│       └── files/                # Input files for evals
+├── skills/
+│   ├── clean-code-reviewer/          # Code review using Clean Code principles
+│   │   ├── SKILL.md
+│   │   └── evals/
+│   │       └── evals.json
+│   ├── [future-skill]/
+│   │   ├── SKILL.md
+│   │   ├── scripts/                  # Executable code (Python/Bash)
+│   │   ├── references/               # Documentation loaded into context as needed
+│   │   ├── assets/                   # Templates, icons, fonts
+│   │   └── evals/                    # Test cases for the skill
+│   │       ├── evals.json
+│   │       └── files/                # Input files for evals
+│   └── ...
 └── ...
 ```
 
@@ -75,13 +77,13 @@ Skills are installed to `.claude/skills/` in your project (or `~/.claude/skills/
 
 ```bash
 # Clone and copy a skill directly
-git clone https://github.com/ZLStas/skills.git
-cp -r skills/effective-kotlin /path/to/project/.claude/skills/
+git clone https://github.com/booklib-ai/skills.git
+cp -r skills/skills/effective-kotlin /path/to/project/.claude/skills/
 ```
 
 ## Automatic Skill Routing
 
-You don't need to know which skill to apply — the **[skill-router](./skill-router/)** meta-skill does it for you.
+You don't need to know which skill to apply — the **[skill-router](./skills/skill-router/)** meta-skill does it for you.
 
 When an AI agent receives a task, it can invoke `skill-router` first to identify the 1–2 most relevant skills based on the file, language, domain, and work type. The router then returns a ranked recommendation with rationale, so the right expertise is applied automatically.
 
@@ -100,24 +102,24 @@ This means skills compose: `skill-router` acts as an orchestrator that picks the
 
 | Skill | Description |
 |-------|-------------|
-| [animation-at-work](./animation-at-work/) | Apply web animation principles from Rachel Nabors' *Animation at Work* — human perception of motion, 12 principles of animation, and performance |
-| [clean-code-reviewer](./clean-code-reviewer/) | Reviews code against Robert C. Martin's *Clean Code* principles with heuristic codes (C1–C5, G1–G36, N1–N7, T1–T9) |
-| [data-intensive-patterns](./data-intensive-patterns/) | Patterns for reliable, scalable, and maintainable systems from Martin Kleppmann's *Designing Data-Intensive Applications* — storage engines, replication, partitioning, and transactions |
-| [data-pipelines](./data-pipelines/) | Data pipeline practices from James Densmore's *Data Pipelines Pocket Reference* — ingestion, streaming, transformation, and orchestration |
-| [design-patterns](./design-patterns/) | Apply and review GoF design patterns from *Head First Design Patterns* — creational, structural, and behavioral patterns |
-| [domain-driven-design](./domain-driven-design/) | Design and review software using patterns from Eric Evans' *Domain-Driven Design* — tactical and strategic patterns, and Ubiquitous Language |
-| [effective-python](./effective-python/) | Python best practices from Brett Slatkin's *Effective Python* (2nd Edition) — Pythonic thinking, functions, classes, concurrency, and testing |
-| [effective-java](./effective-java/) | Java best practices from Joshua Bloch's *Effective Java* (3rd Edition) — object creation, generics, enums, lambdas, and concurrency |
-| [effective-kotlin](./effective-kotlin/) | Best practices from Marcin Moskała's *Effective Kotlin* (2nd Ed) — safety, readability, reusability, and abstraction |
-| [kotlin-in-action](./kotlin-in-action/) | Practices from *Kotlin in Action* (2nd Ed) — functions, classes, lambdas, nullability, and coroutines |
-| [lean-startup](./lean-startup/) | Practices from Eric Ries' *The Lean Startup* — MVP testing, validated learning, Build-Measure-Learn loop, and pivots |
-| [microservices-patterns](./microservices-patterns/) | Expert guidance on microservices patterns from Chris Richardson's *Microservices Patterns* — decomposition, sagas, API gateways, event sourcing, CQRS, and service mesh |
-| [refactoring-ui](./refactoring-ui/) | UI design principles from *Refactoring UI* by Adam Wathan & Steve Schoger — visual hierarchy, layout, typography, and color |
-| [skill-router](./skill-router/) | **Meta-skill.** Automatically selects the 1–2 most relevant skills for a given file, PR, or task — routes by language, domain, and work type with conflict resolution. Use this when the right skill isn't obvious, or let the AI invoke it automatically before applying any skill |
-| [storytelling-with-data](./storytelling-with-data/) | Data visualization and storytelling from Cole Nussbaumer Knaflic's *Storytelling with Data* — effective visuals, decluttering, and narrative structure |
-| [system-design-interview](./system-design-interview/) | System design principles from Alex Xu's *System Design Interview* — scaling, estimation, and real-world system designs |
-| [using-asyncio-python](./using-asyncio-python/) | Asyncio practices from Caleb Hattingh's *Using Asyncio in Python* — coroutines, event loop, tasks, and signal handling |
-| [web-scraping-python](./web-scraping-python/) | Web scraping practices from Ryan Mitchell's *Web Scraping with Python* — BeautifulSoup, Scrapy, and data storage |
+| [animation-at-work](./skills/animation-at-work/) | Apply web animation principles from Rachel Nabors' *Animation at Work* — human perception of motion, 12 principles of animation, and performance |
+| [clean-code-reviewer](./skills/clean-code-reviewer/) | Reviews code against Robert C. Martin's *Clean Code* principles with heuristic codes (C1–C5, G1–G36, N1–N7, T1–T9) |
+| [data-intensive-patterns](./skills/data-intensive-patterns/) | Patterns for reliable, scalable, and maintainable systems from Martin Kleppmann's *Designing Data-Intensive Applications* — storage engines, replication, partitioning, and transactions |
+| [data-pipelines](./skills/data-pipelines/) | Data pipeline practices from James Densmore's *Data Pipelines Pocket Reference* — ingestion, streaming, transformation, and orchestration |
+| [design-patterns](./skills/design-patterns/) | Apply and review GoF design patterns from *Head First Design Patterns* — creational, structural, and behavioral patterns |
+| [domain-driven-design](./skills/domain-driven-design/) | Design and review software using patterns from Eric Evans' *Domain-Driven Design* — tactical and strategic patterns, and Ubiquitous Language |
+| [effective-python](./skills/effective-python/) | Python best practices from Brett Slatkin's *Effective Python* (2nd Edition) — Pythonic thinking, functions, classes, concurrency, and testing |
+| [effective-java](./skills/effective-java/) | Java best practices from Joshua Bloch's *Effective Java* (3rd Edition) — object creation, generics, enums, lambdas, and concurrency |
+| [effective-kotlin](./skills/effective-kotlin/) | Best practices from Marcin Moskała's *Effective Kotlin* (2nd Ed) — safety, readability, reusability, and abstraction |
+| [kotlin-in-action](./skills/kotlin-in-action/) | Practices from *Kotlin in Action* (2nd Ed) — functions, classes, lambdas, nullability, and coroutines |
+| [lean-startup](./skills/lean-startup/) | Practices from Eric Ries' *The Lean Startup* — MVP testing, validated learning, Build-Measure-Learn loop, and pivots |
+| [microservices-patterns](./skills/microservices-patterns/) | Expert guidance on microservices patterns from Chris Richardson's *Microservices Patterns* — decomposition, sagas, API gateways, event sourcing, CQRS, and service mesh |
+| [refactoring-ui](./skills/refactoring-ui/) | UI design principles from *Refactoring UI* by Adam Wathan & Steve Schoger — visual hierarchy, layout, typography, and color |
+| [skill-router](./skills/skill-router/) | **Meta-skill.** Automatically selects the 1–2 most relevant skills for a given file, PR, or task — routes by language, domain, and work type with conflict resolution. Use this when the right skill isn't obvious, or let the AI invoke it automatically before applying any skill |
+| [storytelling-with-data](./skills/storytelling-with-data/) | Data visualization and storytelling from Cole Nussbaumer Knaflic's *Storytelling with Data* — effective visuals, decluttering, and narrative structure |
+| [system-design-interview](./skills/system-design-interview/) | System design principles from Alex Xu's *System Design Interview* — scaling, estimation, and real-world system designs |
+| [using-asyncio-python](./skills/using-asyncio-python/) | Asyncio practices from Caleb Hattingh's *Using Asyncio in Python* — coroutines, event loop, tasks, and signal handling |
+| [web-scraping-python](./skills/web-scraping-python/) | Web scraping practices from Ryan Mitchell's *Web Scraping with Python* — BeautifulSoup, Scrapy, and data storage |
 
 ## License
 

package/bin/skills.js

@@ -7,7 +7,7 @@ const https = require('https');
 
 const args = process.argv.slice(2);
 const command = args[0];
-const skillsRoot = path.join(__dirname, '..');
+const skillsRoot = path.join(__dirname, '..', 'skills');
 
 // ─── ANSI helpers ─────────────────────────────────────────────────────────────
 const c = {

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "@booklib/skills",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Book knowledge distilled into structured AI skills for Claude Code and other AI assistants",
   "bin": {
-    "skills": "./bin/skills.js"
+    "skills": "bin/skills.js"
   },
-  "keywords": ["claude", "claude-code", "ai", "skills", "agent-skills"],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "skills",
+    "agent-skills"
+  ],
   "license": "MIT",
+  "homepage": "https://github.com/booklib-ai/skills#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/agent-skills/skills.git"
+    "url": "git+https://github.com/booklib-ai/skills.git"
   },
   "engines": {
     "node": ">=16"