chore: restructure skills repo with new agents and skill bundles

- Add new skills: deep-dive, docs-rag, meta-creator, ppt-maker, sdlc
- Add agent configs: g-assistent, meta-creator, sdlc with prompt files
- Add reference docs for custom agents and skills specification
- Add utility scripts: install-agents.sh, orchestrate.py, puml2svg.sh
- Update README and commit-message skill config
- Remove deprecated skills: codereview, python, testing, typescript
- Add .gitignore

README.md

@@ -2,26 +2,41 @@
 
 Shared Kiro agent skills for the team. All skills are evaluated before merge.
 
-## Structure
+## Skills
+
+| Skill | Description |
+|---|---|
+| [commit-message](skills/commit-message/README.md) | Generate Conventional Commits messages from staged changes |
+| [deep-dive](skills/deep-dive/README.md) | Produce structured technical reports from code, docs, or URLs |
+| [docs-rag](skills/docs-rag/README.md) | RAG over local 3GPP Release 19 specification documents |
+| [meta-creator](skills/meta-creator/README.md) | Create and iterate on agent skills and custom agents |
+| [ppt-maker](skills/ppt-maker/README.md) | Convert Markdown to professional PPTX with auto-charts |
+| [sdlc](skills/sdlc/README.md) | Guide a full software development lifecycle end-to-end |
+
+## Repository Structure
 
 ```
 skills/
-├── codereview/
+├── commit-message/
 │   ├── SKILL.md
-│   └── evals/evals.json
+│   ├── README.md
+│   ├── assets/          ← architecture.svg, workflow.svg + .puml sources
+│   ├── evals/evals.json
+│   └── references/
+├── deep-dive/
 ├── docs-rag/
-│   ├── SKILL.md
-│   ├── data/index.json
-│   └── evals/evals.json
-├── python/
-├── testing/
-└── typescript/
+├── meta-creator/
+├── ppt-maker/
+└── sdlc/
 scripts/
-├── run_evals.py   ← eval runner with regression protection
-└── sync.sh        ← sync skills into a project
+├── run_evals.py         ← eval runner with regression protection
+├── puml2svg.sh          ← convert .puml diagrams to SVG
+├── sync.sh              ← sync skills into a project
+├── install-agents.sh    ← install agent configs into a project
+└── orchestrate.py       ← multi-skill orchestration
 .githooks/
-└── pre-push       ← blocks push if changed skills regress
-baselines.json     ← recorded pass rates (committed to repo)
+└── pre-push             ← blocks push if changed skills regress
+baselines.json           ← recorded pass rates (committed to repo)
 ```
 
 ## Using Skills in Your Project
@@ -31,18 +46,37 @@ baselines.json     ← recorded pass rates (committed to repo)
 COMMON_SKILLS_DIR=~/common-skills bash scripts/sync.sh
 
 # Sync specific skills only
-COMMON_SKILLS_DIR=~/common-skills bash scripts/sync.sh codereview python
+COMMON_SKILLS_DIR=~/common-skills bash scripts/sync.sh commit-message ppt-maker
 ```
 
 ## Contributing a New Skill
 
 1. Create `skills/<name>/SKILL.md` with YAML frontmatter (`name`, `description`)
 2. Add `skills/<name>/evals/evals.json` with at least 3 eval cases
-3. Run evals locally and update baseline:
+3. Add architecture and workflow diagrams:
+   ```bash
+   # Create skills/<name>/assets/architecture.puml and workflow.puml, then:
+   bash scripts/puml2svg.sh <name>
+   ```
+4. Run evals locally and update baseline:
    ```bash
    python scripts/run_evals.py <name> --update-baseline
    ```
-4. Push — the pre-push hook will verify no regressions on changed skills
+5. Push — the pre-push hook will verify no regressions on changed skills
+
+## Updating Diagrams
+
+Each skill stores PlantUML source files in `assets/` alongside the rendered SVGs.
+
+```bash
+# Regenerate all SVGs
+bash scripts/puml2svg.sh
+
+# Regenerate a single skill
+bash scripts/puml2svg.sh deep-dive
+```
+
+Requires Java and Graphviz (`apt install graphviz`). The PlantUML jar is resolved automatically from the VS Code extension path; override with `PLANTUML_JAR=/path/to/plantuml.jar`.
 
 ## Running Evals
 
@@ -51,13 +85,13 @@ COMMON_SKILLS_DIR=~/common-skills bash scripts/sync.sh codereview python
 python scripts/run_evals.py
 
 # Run single skill
-python scripts/run_evals.py codereview
+python scripts/run_evals.py commit-message
 
 # Check for regressions against baselines.json
 python scripts/run_evals.py --check-regression
 
 # After improving a skill, record new baseline
-python scripts/run_evals.py codereview --update-baseline
+python scripts/run_evals.py commit-message --update-baseline
 ```
 
 ## Install pre-push Hook