docs(skill): Move dotagents skill to top-level and update content

[gricha]

Move the dotagents skill from plugins/dotagents/skills/ to the top-level skills/ directory and symlink it back from the plugin structure. This keeps the source of truth at the repo level rather than buried in the plugin tree.

Also updates the skill content to match the current CLI after recent PRs (#34, #35, #36):

• Add mcp command (was completely missing from commands table and cli-reference)
• Add positional skill args and multi-skill support to add command
• Add --skill alias alongside --name
• Add list --json flag
• Fix install --force description (it bypasses the lockfile, not reinstalls)
• Expand source formats with GitHub SSH and HTTPS URLs
• Add hooks to Key Concepts section
• Document interactive prompt behavior on wildcard remove
• Add headers field to HTTP MCP example in configuration reference

Agent transcript: https://claudescope.sentry.dev/share/wmsIuw4whFWDbrLlaEhCzBR9tSiCVLSnVawOUnPYyhw

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dotagents	Ready	Preview, Comment	Feb 24, 2026 0:15am

[sentry]

Bug: The new symlink at plugins/dotagents/skills/dotagents will fail to create on standard Windows environments, causing CLI commands to crash due to permission errors.
_{Severity: HIGH}

Suggested Fix

Implement platform-specific logic for creating symlinks. On Windows, check for permissions and consider falling back to creating a directory junction if creating a symlink fails. Add a Windows runner to the CI/CD pipeline to test this behavior.

Prompt for AI Agent

Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: plugins/dotagents/skills/dotagents#L1

Potential issue: The code uses Node.js's `fs.symlink()` API to create a symlink at
`plugins/dotagents/skills/dotagents`. This API lacks cross-platform handling and has
known issues on Windows, where creating symlinks typically requires Administrator
privileges or Developer Mode. For Windows users without these permissions, CLI commands
like `dotagents init` or `dotagents sync` will attempt to create the symlink and fail
with an `EPERM` error, causing the command to crash. The CI pipeline only runs on Linux,
so this platform-specific issue was not caught during testing.

_{Did we get this right? 👍 / 👎 to inform future reviews.}