index e4fe0eb..9b1576e 100644
@@ -4,44 +4,42 @@ visibility: public
# Awesome Claude Skills
-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.
+the comprehensive directory. not a link dump — an opinionated guide to what's actually worth installing.
-## what are skills?
+sourced from [Anthropic's official repo](https://github.com/anthropics/skills), [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills), [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills), [obra/superpowers](https://github.com/obra/superpowers), [Trail of Bits](https://github.com/trailofbits/skills), company repos (Vercel, Cloudflare, HashiCorp, Stripe, Expo, etc.), individual GitHub repos, and the [vibe coding manifesto](https://www.moonflowers.xyz/writing/vibe_coding_manifesto).
-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 most important thing about skills
-the skill structure is simple:
-```
-skill-name/
-├── SKILL.md # instructions + YAML frontmatter
-├── scripts/ # optional helpers
-├── templates/ # optional templates
-└── resources/ # optional reference files
-```
+> **good tools/skills, not many tools/skills.** issues with many tools/skills: context window jumbling → increased confusion. they might think certain tools are to be used but they aren't actually good. — [vibe coding manifesto](https://www.moonflowers.xyz/writing/vibe_coding_manifesto)
-## categories
+one developer tested 200+ skills and found **most publicly available skills actively hurt performance** — adding tokens, latency, and constraints that make output worse. install selectively.
-**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
+## quality tiers
-**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
+- **[[official]]** — Anthropic's 17 skills + bundled Claude Code skills. the gold standard.
+- **[[company-skills]]** — Vercel, Cloudflare, Trail of Bits, HashiCorp, Stripe, Expo, etc. — companies writing skills for their own products. high trust.
+- **[[frameworks]]** — obra/superpowers, context-engineering-kit, everything-claude-code. development methodologies, not just individual skills.
+- **community picks** — individual skills that solve real problems. curated by category below.
-**security:**
-- [[security]] — web fuzzing, threat hunting, forensics, metadata extraction
+## by category
-**automation skills (via Composio):**
-- [[app-automation]] — 78 SaaS integrations: CRM, project management, email, social, payments, etc.
+**code & engineering:**
+- [[development]] — testing, git, architecture, specialized tools
+- [[design-and-frontend]] — UI/UX, frontend frameworks, design systems
+- [[security]] — Trail of Bits' 40+ security skills, fuzzing, forensics, threat hunting
-**meta:**
-- [[creating-skills]] — how to build your own
-- [[resources]] — official docs, community links
+**content & output:**
+- [[document-processing]] — Word, PDF, Excel, PowerPoint, EPUB
+- [[creative-and-media]] — image generation, video, GIFs, D3 visualizations, algorithmic art
+- [[communication-and-writing]] — content writing, meeting analysis, brainstorming, research
-## editorial note
+**workflow:**
+- [[productivity]] — file organization, knowledge management, task workflows, n8n
+- [[business-and-marketing]] — lead research, SEO, competitive analysis, PM skills
+- [[app-automation]] — 78 SaaS integrations via Composio
-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
+**meta:**
+- [[frameworks]] — development methodologies and multi-skill systems
+- [[tooling]] — skill creators, installers, marketplaces, orchestrators
+- [[creating-skills]] — how to build your own
+- [[resources]] — official docs, guides, community links, the manifesto
\ No newline at end of file