Update README with skills documentation

README.md

@@ -1,3 +1,26 @@
-# skills-library
+# Skills Library
 
-Claude Skills library for the Agentic Development Platform
+Claude Skills library for the Agentic Development Platform. Skills are token-optimized prompts that enable efficient, deterministic AI workflows.
+
+## Structure
+
+```
+skills/
+├── project/         # Project management skills
+├── sprint/          # Sprint planning skills  
+├── code/           # Code review and generation
+├── design/         # Design collaboration
+└── design-thinking/ # Design thinking methodology
+templates/
+└── skill-template.md
+```
+
+## Usage
+
+Skills are loaded by n8n workflows and executed via Claude API with structured prompts for minimal token usage.
+
+## Key Concepts
+
+- **Skills vs Agents**: Skills are focused prompts (~800 tokens), agents are autonomous processes (~5000+ tokens)
+- **Token Budget**: Each skill has a max token limit to control costs
+- **Structured Output**: JSON responses enable automation