Skip to content

chore: add docs skills and update doc guides#2284

Open
mariechatfield wants to merge 1 commit into
mainfrom
chore/marie/add-more-skills
Open

chore: add docs skills and update doc guides#2284
mariechatfield wants to merge 1 commit into
mainfrom
chore/marie/add-more-skills

Conversation

@mariechatfield

Copy link
Copy Markdown
Contributor

Summary

Adds three new Claude Code skills for docs work, consolidates reference material into .claude/doc-guides/, and fixes stale content in the tsdoc guides.

Changes

  • New skills: docs-check (build gate + flow quality checklist), docs-regen, docs-change-ia (with companion REFERENCE.md on the TypeDoc plugin internals)
  • Renamed .claude/tsdoc-guides/.claude/doc-guides/; moved docs-shared.md in from the skills root
  • flows.md: fixed stale @example guidance (was "skip, use @see to workflows-overview"); added @components correctness pitfalls (umbrella trap, wrapper collapse, cross-namespace); added hub vs. guided flow @example conventions
  • hooks.md, components.md: removed stale docs/workflows-overview/ references
  • Updated path references in tsdoc/SKILL.md and tsdoc-auditor.md
  • Added regen to cspell.json

Testing

Claude Code skills only — no SDK code changes. Invoke /docs-check, /docs-regen, and /docs-change-ia and verify guidance is coherent. Check that tsdoc and tsdoc-auditor still load the correct guides from .claude/doc-guides/.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@mariechatfield mariechatfield marked this pull request as ready for review June 26, 2026 16:35
@mariechatfield mariechatfield requested a review from a team as a code owner June 26, 2026 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant