docs(skills): document the skills installer and dhq skills command

[facundofarias]

Summary

PRs #25 (dhq launch) and #26 (skills installer) merged, but only dhq launch made it into the docs. This brings the skills installer up to date.

• Quick Start — dhq hello now notes it offers to install the DeployHQ skill into detected agents, plus a standalone dhq skills install line.
• Command list — adds dhq skills list | install.
• Agent Integration — new subsection leading with dhq skills install (auto-detects 12 agents, installs into each native format, user-scope vs project-scope --agent), and reframes dhq setup as the narrower per-agent alternative.
• CLAUDE.md — adds internal/skillinstaller/ to the architecture map.
• hello.go — extends the command's long description so --help matches the new onboarding behaviour.

Docs-only, plus the one --help string — no behaviour change.

Note on dhq setup vs dhq skills

These overlap: dhq setup <agent> installs the skill for 4 agents; dhq skills install auto-detects and covers 12. This PR documents dhq skills as the primary path and keeps dhq setup as a documented alternative. Whether to formally deprecate dhq setup in code is left as a follow-up decision.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation

  • Expanded guided setup instructions with clearer login, signup, project selection, and first deploy context, split into dhq signup, dhq auth login, and dhq configure.
  • Added a new dhq skills command to list and install the DeployHQ skill for detected AI agents.
  • Documented supported agents, user-scope vs project-scope installation behavior, and the --agent requirement for project-scoped installs, plus updated agent helper examples.

• Refactor

  • Updated dhq hello help text to include the DeployHQ skill installation step as part of guided setup.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2eefd8b6-5eeb-414c-ab42-0e86ccb0e6b3

📥 Commits

Reviewing files that changed from the base of the PR and between 1719d5a and 87ab18d.

📒 Files selected for processing (2)

• README.md
• internal/commands/hello.go

✅ Files skipped from review due to trivial changes (1)

• internal/commands/hello.go

🚧 Files skipped from review as they are similar to previous changes (1)

• README.md

---

Walkthrough

Documentation and CLI help text were updated to describe dhq skills: guided setup was expanded, the command catalog gained dhq skills, the agent-installation section was rewritten, CLAUDE.md added an architecture note, and hello.go mentions agent skill installation.

Changes

dhq skills documentation and hello command update

Layer / File(s)

Summary

Skills docs and help text README.md, CLAUDE.md, internal/commands/hello.go

README.md expands guided setup, adds dhq skills to the command catalog, and rewrites the agent skill installation section around dhq skills list/install, supported agents, scope behavior, and helper commands. CLAUDE.md adds an internal/skillinstaller/ architecture entry. internal/commands/hello.go updates the long help text to mention installing the DeployHQ skill for detected local AI coding agents.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the docs-focused addition of the skills installer and the new dhq skills command.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/skills-installer

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@internal/commands/hello.go`:
- Line 24: The `hello` command description in `hello` overstates what the
workflow does by saying it installs the skill into “any” detected AI coding
agents. Update the `Long` description to reflect the actual behavior: it guides
login/account/project setup and offers skill installs for detected agents, while
project-scope targets are skipped unless `--agent` is provided.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d3e2440c-0764-4e1c-9013-c4db26589690

📥 Commits

Reviewing files that changed from the base of the PR and between 902a45f and 1719d5a.

📒 Files selected for processing (3)

• CLAUDE.md
• README.md
• internal/commands/hello.go