index 1ea14c5..e4fe0eb 100644
@@ -1,7 +1,47 @@
-# awesome-claude-skills
+---
+visibility: public
+---
-catalog of all wiki pages. update on every ingest.
+# Awesome Claude Skills
-## pages
+a curated directory of Claude Skills — reusable instruction packages that extend what Claude can do. sourced from [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) (53k+ stars) and reorganized for actual usability.
-(none yet)
+## what are skills?
+
+skills are markdown instruction files that teach Claude repeatable workflows. drop a `SKILL.md` into `~/.config/claude-code/skills/` and Claude Code picks it up automatically. they also work in Claude.ai (via the skill icon) and the API.
+
+the skill structure is simple:
+```
+skill-name/
+├── SKILL.md # instructions + YAML frontmatter
+├── scripts/ # optional helpers
+├── templates/ # optional templates
+└── resources/ # optional reference files
+```
+
+## categories
+
+**core skills — the ones worth installing:**
+- [[development]] — coding tools, testing, git workflows, architecture
+- [[document-processing]] — Word, PDF, Excel, PowerPoint, EPUB
+- [[data-and-analysis]] — CSV analysis, research, database queries, debugging
+- [[creative-and-media]] — image generation, video, GIFs, D3 visualizations
+
+**workflow skills:**
+- [[communication-and-writing]] — content writing, meeting analysis, brainstorming
+- [[productivity]] — file organization, invoices, resumes, task workflows
+- [[business-and-marketing]] — lead research, brand guidelines, competitive analysis, domain names
+
+**security:**
+- [[security]] — web fuzzing, threat hunting, forensics, metadata extraction
+
+**automation skills (via Composio):**
+- [[app-automation]] — 78 SaaS integrations: CRM, project management, email, social, payments, etc.
+
+**meta:**
+- [[creating-skills]] — how to build your own
+- [[resources]] — official docs, community links
+
+## editorial note
+
+the original awesome-list is ~50% Composio product promotion. this wiki strips the marketing and focuses on what's actually useful. the [[app-automation]] section is kept but separated — it's Composio's connect-apps plugin, which is genuinely useful if you want Claude to interact with SaaS tools, but it's one product, not an open ecosystem.
\ No newline at end of file