docs: rewrite README for first-time readers

[cursor]

🤖 Generated by the Agentic Engineer (Cursor cloud instance)

Part of devantler-tech/monorepo#2225 — real sub-issue for the remaining agent-skills README rewrite.

Evidence

agent-skills is on the monorepo#2225 remaining list; front page should lead with what a consumer gets from the skill library.

Audience / problem

A first-time visitor needs "what is this, is it for me, what do I run first" in the first screen.

Success signal (from parent)

• First two sentences say what it is and who it is for.
• Front page fits roughly one screen; reference linked, not inlined.
• Technical terms explained on first use in common words.
• Getting-started commands copy-pasteable and correct.
• Internal maintenance detail lives in AGENTS.md, not the README.

Guardrail: move detail; do not delete what readers need.

Size

S.

[coderabbitai]

🔗 Related PRs

#58 - docs: repoint update-agent-skills workflow link off reusable-workflows [merged]
#70 - docs: document the npx skills install path alongside gh skill [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!