new file mode 100644
index 0000000..8bbef5a
@@ -0,0 +1,59 @@
+---
+visibility: public
+---
+
+# resources
+
+## official documentation
+
+- [Agent Skills specification](https://agentskills.io/specification) — the standard
+- [Extend Claude with skills](https://code.claude.com/docs/en/skills) — Claude Code docs
+- [Agent Skills overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) — platform docs
+- [Skills User Guide](https://support.claude.com/en/articles/12512180-using-skills-in-claude) — how to use skills
+- [Creating Custom Skills](https://support.claude.com/en/articles/12512198-creating-custom-skills) — development guide
+- [Agent Skills blog post](https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) — engineering deep dive
+- [Anthropic Skilljar course](https://anthropic.skilljar.com/introduction-to-agent-skills) — interactive training
+
+## key repositories
+
+- [anthropics/skills](https://github.com/anthropics/skills) — official skills (17 skills)
+- [anthropics/claude-code](https://github.com/anthropics/claude-code) — Claude Code itself
+- [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) — official plugin directory
+- [obra/superpowers](https://github.com/obra/superpowers) — leading framework (147k stars)
+- [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) — Vercel's skills (24.9k stars)
+- [trailofbits/skills](https://github.com/trailofbits/skills) — security skills (40+)
+- [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) — comprehensive guide (151k stars)
+
+## awesome lists (the best ones)
+
+- [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) (15.2k stars) — "hand-picked, not AI-slop." 1,086+ skills.
+- [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) (38.1k stars) — skills, hooks, commands, plugins.
+- [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) (11k stars) — best editorial quality.
+- [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) (53k stars) — the original.
+
+## philosophy & methodology
+
+- **[vibe coding manifesto](https://www.moonflowers.xyz/writing/vibe_coding_manifesto)** — principles for working with agents: leverage, good tools not many tools, spec-driven development, context management, verification.
+- [2026 Agentic Coding Trends Report](https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf) — Anthropic's research on agent development trends.
+- [Effective harnesses for long-running agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents) — Anthropic engineering.
+- [Code proven to work](https://simonwillison.net/2025/Dec/18/code-proven-to-work/) — Simon Willison on verification.
+- [Why Ramp built their background agent](https://engineering.ramp.com/post/why-we-built-our-background-agent) — verification in practice.
+- [How Anthropic teams use Claude Code](https://www-cdn.anthropic.com/58284b19e702b49db9302d5b6f135ad8871e7658.pdf) — internal practices.
+- [Best Claude Code Skills to Try](https://www.firecrawl.dev/blog/best-claude-code-skills) — Firecrawl's substantive quality assessment.
+
+## community
+
+- [Claude Community](https://community.anthropic.com) — forums
+- [Skills Marketplace](https://claude.ai/marketplace) — official marketplace
+- [Claude feature-dev plugin](https://github.com/anthropics/claude-code/tree/main/plugins/feature-dev) — development workflow plugin
+- [vibe-coding-guide](https://github.com/tmad4000/vibe-coding-guide) — tips and app recommendations
+- [learn-claude-code](https://github.com/shareAI-lab/learn-claude-code) — beginner resource
+
+## mega-collections (if you want everything)
+
+- [sickn33/antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) (32.3k stars) — 1,370+ installable skills with CLI.
+- [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) (10.5k stars) — 232+ cross-agent skills.
+- [Jeffallan/claude-skills](https://github.com/Jeffallan/claude-skills) (8.1k stars) — 66 full-stack skills.
+- [rohitg00/awesome-claude-code-toolkit](https://github.com/rohitg00/awesome-claude-code-toolkit) (1.2k stars) — 135 agents, 35 skills, 42 commands, 176 plugins, 20 hooks.
+
+**warning:** bulk-installing hundreds of community skills is almost always counterproductive. see the index for why.
\ No newline at end of file