fix[skill]: consolidate into single self-contained SKILL.md

[TimPietrusky]

Summary

The skill was split across 4 files (SKILL.md + 3 reference docs) and was missing CLI installation instructions entirely, making it broken for first-time agent use. This PR consolidates everything into a single self-contained SKILL.md.

What changed:

• Added install instructions — curl script + npm i -g so agents can guide users through installation
• Split auth by platform — macOS (automatic via Desktop/Chrome) and Linux/Windows (manual) with clear headings instead of "fallback" wording
• Added step-by-step parse-curl guide — tells users exactly what to look for in DevTools: filter for api, find requests to <workspace>.slack.com/api/ (e.g. api/client.counts), copy as cURL
• One big command reference block — every command as a commented one-liner, easy to scan (follows the pattern from the runpodctl skill)
• Merged reference docs — targets (URL format, G.../D... IDs, SLACK_WORKSPACE_URL env var), output (JSON shapes, download paths, default truncation values), and missing flags (--thread-ts, --cursor, repeatable --channel)
• Removed reference files — commands.md, targets.md, output.md are no longer needed

Why a single file is better:

• Agents load one file and have everything they need — no cross-referencing
• Easier to maintain — one place to update
• Tested on Linux with Claude Code — agent successfully guided through install, parse-curl auth, and all commands

Test plan

• Tested skill loading in Claude Code
• Tested Linux auth flow (parse-curl) guided by agent
• Verified all commands from original reference docs are covered
• Verified install instructions match README

[nwparker]

Thanks for the consolidation work here. I ran a 3-agent review plus a source-grounded pass against the Agent Skills spec and Anthropic best-practices, then implemented the outcome in a standalone PR from master.

Implemented follow-up PR (new standalone PR):

• docs(skill): keep hybrid skill format and enforce docs sync #32

Reasoning (consolidated):

• Keep: install/setup guidance in SKILL.md (important for first-run reliability)
• Keep: platform-specific auth guidance (macOS auto vs Linux/Windows manual paths)
• Keep: short common-command block in SKILL.md
• Do not fully collapse into one file: keep references/commands.md, references/targets.md, and references/output.md
• Why: SKILL.md is fully loaded on activation; progressive disclosure keeps context cost lower and reduces drift risk for growing command surfaces
• Enforcement: added scripts/check-docs-sync.sh and wired bun run docs:check into CI/release

Background research (uploaded):

• Gist (all 3 docs): https://gist.github.com/nwparker/28bd645ad4fd14893bf8f1c77fa707da
• Claude report: https://gist.githubusercontent.com/nwparker/28bd645ad4fd14893bf8f1c77fa707da/raw/1bb067ba08544cad85c9f9f558e7a46e0d2fd857/skill-format-claude.md
• Codex report: https://gist.githubusercontent.com/nwparker/28bd645ad4fd14893bf8f1c77fa707da/raw/53284291c44be12990bc2119c10b026b420dc284/skill-format-from-codex.md
• Gemini report: https://gist.githubusercontent.com/nwparker/28bd645ad4fd14893bf8f1c77fa707da/raw/e5a8cc70182ccff307b8ff5dc9de1f2517a5798a/skill-format-gemini.md

Note: This is a triggered AI response.

[nwparker]

Sorry about this! I had to rename the default branch from main to master for npx skills compatibility, and unfortunately GitHub auto-closed this PR and won't allow reopening it.

The branch and commits are all still intact — if you'd like to continue, you can open a new PR targeting master. Apologies for the inconvenience!