refactor: move all skills to skills/ subdirectory

Moves all skills from repo root to skills/ subdirectory for cleaner
organization. Root now only contains README, LICENSE, package.json, and
repo metadata.

Structure:
  /
  ├── README.md
  ├── LICENSE
  └── skills/
      ├── azcli/
      │   ├── SKILL.md
      │   └── ref/
      ├── gcloud/
      └── ...

Updated package.json (files, pi.skills), README (table, structure),
and regenerated .well-known/skills/index.json.

Verified: 'npx skills add <repo> --list' still finds 8/8 skills ✅

Co-Authored-By: Pi <noreply@pi.dev>

Author: marcfargas

.changeset/flatten-directory-structure.md

@@ -2,19 +2,29 @@
 "@marcfargas/skills": patch
 ---
 
-Flatten directory structure for skills CLI compatibility.
+Restructure for skills CLI compatibility and cleaner organization.
 
-All skills are now at the top level (e.g., `azcli/`, `gcloud/`) instead of nested in category folders (`azure/azcli/`, `google-cloud/gcloud/`). Progressive discovery reference files moved to `ref/` subdirectories to prevent pi from detecting them as separate skills.
+All skills moved to `skills/` subdirectory with flat structure. Progressive discovery reference files in `ref/` subdirectories.
 
-**Before:** 1/8 skills found by default (npx skills add)  
-**After:** 8/8 skills found by default ✅
+**Before:** Nested category folders, 1/8 skills found by default  
+**After:** Flat `skills/` directory, 8/8 skills found by default ✅
 
 **Structure:**
 ```
-azcli/
-├── SKILL.md       ← hub (150 lines)
-└── ref/           ← loaded on demand
-    ├── auth.md
-    ├── storage.md
+/
+├── README.md
+├── LICENSE
+└── skills/
+    ├── azcli/
+    │   ├── SKILL.md    ← hub (~150 lines)
+    │   └── ref/        ← loaded on demand
+    │       ├── auth.md
+    │       └── ...
+    ├── gcloud/
     └── ...
 ```
+
+**Key improvements:**
+- `npx skills add marcfargas/skills` discovers all 8 skills (no `--full-depth` needed)
+- Pi only detects `SKILL.md` files (not reference docs)
+- Cleaner repo root (README, LICENSE separate from skills)

.well-known/skills/index.json

@@ -5,42 +5,42 @@
     {
       "name": "azcli",
       "description": "Azure CLI (az). Use when: managing Azure resources, deploying to App Service/Functions/Container Apps/AKS, working with Storage, SQL Database, Cosmos DB, VMs, VNets, NSGs, Key Vault, Entra ID (Azure AD), RBAC, Service Bus, Event Hubs, Container Registry, Azure Monitor, DNS, or any Azure service. Also covers: authentication, subscription management, CI/CD integration (GitHub Actions/Azure DevOps), Bicep/ARM templates, managed identities, and infrastructure automation.",
-      "path": "azcli"
+      "path": "skills/azcli"
     },
     {
       "name": "gcloud",
       "description": "Google Cloud Platform CLI (gcloud, gcloud storage, bq). Use when: managing GCP resources, deploying to Cloud Run/Cloud Functions/GKE/App Engine, working with Cloud Storage, BigQuery, IAM, Compute Engine, Cloud SQL, Pub/Sub, Secret Manager, Artifact Registry, Cloud Build, Cloud Scheduler, Cloud Tasks, Vertex AI, VPC/networking, DNS, logging/monitoring, or any GCP service. Also covers: authentication, project/config management, CI/CD integration, serverless deployments, container registry, docker push to GCP, managing secrets, Workload Identity Federation, and infrastructure automation.",
-      "path": "gcloud"
+      "path": "skills/gcloud"
     },
     {
       "name": "pm2",
       "description": "Process management with PM2 — start, stop, restart, monitor long-running processes. Use when: keeping services alive, auto-restart on crash, managing daemon processes, ecosystem configs, log management, startup scripts, process monitoring. Triggers: pm2, process manager, keep alive, daemon, auto-restart, ecosystem config, process monitoring.",
-      "path": "pm2"
+      "path": "skills/pm2"
     },
     {
       "name": "pre-release",
       "description": "Pre-release review and changeset generation for npm packages using @changesets/cli. Use when: preparing a release, generating changelogs, pre-release checklist, version bump, writing release notes, reviewing README before publish. Triggers: \"prepare release\", \"pre-release\", \"generate changelog\", \"write changesets\", \"release checklist\".",
-      "path": "pre-release"
+      "path": "skills/pre-release"
     },
     {
       "name": "repo-hygiene",
       "description": "Periodic repository health check — dependencies, git, CI/CD, code quality, docs, security. Use when: onboarding to a repo, weekly maintenance, after big refactors, before audits, \"is this repo in good shape?\". Triggers: \"repo hygiene\", \"health check\", \"repo health\", \"clean up repo\", \"maintenance check\", \"audit repo\", \"repo audit\".",
-      "path": "repo-hygiene"
+      "path": "skills/repo-hygiene"
     },
     {
       "name": "sheet-model",
       "description": "Headless spreadsheet engine for financial modeling, data analysis, and scenario comparison. Use when: building financial models with ratios and what-if scenarios, computing derived values from tabular data with formulas, producing .xlsx files with live formulas (not static values) for human review, any task where the agent would otherwise write imperative code to manipulate numbers that a spreadsheet does naturally. Triggers: financial model, scenario analysis, ratio computation, balance sheet, P&L, what-if, sensitivity analysis, banking ratios, spreadsheet model, build a model, projection, forecast. Do NOT use for: simple CSV/Excel read/write (use the xlsx skill), chart-only tasks, or data volumes exceeding ~5000 rows.",
-      "path": "sheet-model"
+      "path": "skills/sheet-model"
     },
     {
       "name": "vhs",
       "description": "Record terminal sessions as GIF/MP4/WebM using VHS (Charm.sh). Use when: create demo GIF, record terminal, terminal recording, demo video, tape file, animate CLI, screencast terminal, showcase command output, README demo, document CLI tool, generate terminal animation.",
-      "path": "vhs"
+      "path": "skills/vhs"
     },
     {
       "name": "web-search",
       "description": "Web search and content extraction using ddgs (multi-engine metasearch). No API keys required. Use when: searching documentation, facts, current information, news, fetching web content. Triggers: search the web, look up, find information, web search, news search, fetch page.",
-      "path": "web-search"
+      "path": "skills/web-search"
     }
   ]
 }

README.md

@@ -6,14 +6,14 @@ Reusable skills for AI coding agents. Works with [pi](https://github.com/marioze
 
 | Category | Skill | Description |
 |----------|-------|-------------|
-| ☁️ Azure | [azcli](azcli/) | Azure CLI with agent safety model — hub + reference files |
-| ☁️ Google Cloud | [gcloud](gcloud/) | GCP CLI with agent safety model — hub + 7 reference files |
-| 🔧 Maintenance | [repo-hygiene](repo-hygiene/) | Periodic repo health check — deps, git, CI, code quality, docs, security |
-| ⚙️ Process | [pm2](pm2/) | Process management — keep services alive, auto-restart, monitoring, ecosystem configs |
-| 🚀 Release | [pre-release](pre-release/) | Pre-release checklist + AI-written changesets via @changesets/cli |
-| 🔍 Search | [web-search](web-search/) | Web search + content extraction via [ddgs](https://github.com/deedy5/ddgs) — no API keys |
-| 📊 Modeling | [sheet-model](sheet-model/) | Headless spreadsheet engine for financial modeling, scenario analysis, .xlsx with live formulas |
-| 🎬 Terminal | [vhs](vhs/) | Record terminal sessions as GIF/MP4 with [VHS](https://github.com/charmbracelet/vhs) |
+| ☁️ Azure | [azcli](skills/azcli/) | Azure CLI with agent safety model — hub + reference files |
+| ☁️ Google Cloud | [gcloud](skills/gcloud/) | GCP CLI with agent safety model — hub + 7 reference files |
+| 🔧 Maintenance | [repo-hygiene](skills/repo-hygiene/) | Periodic repo health check — deps, git, CI, code quality, docs, security |
+| ⚙️ Process | [pm2](skills/pm2/) | Process management — keep services alive, auto-restart, monitoring, ecosystem configs |
+| 🚀 Release | [pre-release](skills/pre-release/) | Pre-release checklist + AI-written changesets via @changesets/cli |
+| 🔍 Search | [web-search](skills/web-search/) | Web search + content extraction via [ddgs](https://github.com/deedy5/ddgs) — no API keys |
+| 📊 Modeling | [sheet-model](skills/sheet-model/) | Headless spreadsheet engine for financial modeling, scenario analysis, .xlsx with live formulas |
+| 🎬 Terminal | [vhs](skills/vhs/) | Record terminal sessions as GIF/MP4 with [VHS](https://github.com/charmbracelet/vhs) |
 
 ## Install
 
@@ -71,16 +71,18 @@ Skills use a **hub + spoke** architecture. The SKILL.md hub is ~140 lines — ju
 ## Structure
 
 ```text
-skills/
-├── azcli/               # Azure CLI — hub + 7 reference files
-├── gcloud/              # GCP CLI — hub + 7 reference files
-├── repo-hygiene/        # Periodic repo health check
-├── pm2/                 # Process management
-├── pre-release/         # Pre-release checklist + changesets
-├── web-search/          # Web search + content extraction
-├── sheet-model/         # Headless spreadsheet engine
-├── vhs/                 # Terminal session recording
-└── README.md
+.
+├── README.md
+├── LICENSE
+└── skills/
+    ├── azcli/          # Azure CLI — hub + 7 reference files
+    ├── gcloud/         # GCP CLI — hub + 7 reference files
+    ├── repo-hygiene/   # Periodic repo health check
+    ├── pm2/            # Process management
+    ├── pre-release/    # Pre-release checklist + changesets
+    ├── web-search/     # Web search + content extraction
+    ├── sheet-model/    # Headless spreadsheet engine
+    └── vhs/            # Terminal session recording
 ```
 
 ## External Skills

package.json

@@ -24,14 +24,14 @@
   ],
   "pi": {
     "skills": [
-      "azcli",
-      "gcloud",
-      "repo-hygiene",
-      "pm2",
-      "pre-release",
-      "web-search",
-      "sheet-model",
-      "vhs"
+      "skills/azcli",
+      "skills/gcloud",
+      "skills/repo-hygiene",
+      "skills/pm2",
+      "skills/pre-release",
+      "skills/web-search",
+      "skills/sheet-model",
+      "skills/vhs"
     ]
   },
   "scripts": {
@@ -49,14 +49,7 @@
   },
   "files": [
     ".well-known/",
-    "azcli/",
-    "gcloud/",
-    "repo-hygiene/",
-    "pm2/",
-    "pre-release/",
-    "web-search/",
-    "sheet-model/",
-    "vhs/",
+    "skills/",
     "!**/node_modules",
     "!**/package-lock.json",
     "README.md",