Skip to content

feat: add enhance-claude-docs skill and weekly workflow#351

Merged
ninja-shreyash merged 2 commits intomainfrom
sv/enhance-claude-workflow
Apr 7, 2026
Merged

feat: add enhance-claude-docs skill and weekly workflow#351
ninja-shreyash merged 2 commits intomainfrom
sv/enhance-claude-workflow

Conversation

@ninja-shreyash
Copy link
Copy Markdown
Contributor

@ninja-shreyash ninja-shreyash commented Apr 7, 2026

Summary

Adds infrastructure for automated weekly Claude documentation enhancement:

  • enhance-claude-docs skill that extracts PR review comments, analyzes them for documentation-worthy insights, and proposes updates via PR
  • claude-docs-update.yml GitHub Actions workflow (weekly Monday 9am UTC cron + manual workflow_dispatch)

How it works

  1. Cron/dispatch/manual triggers the skill
  2. Skill fetches all PRs from last N days via gh api
  3. Extracts inline review comments + conversation threads
  4. Filters out bot comments and noise
  5. Analyzes against current agent_docs/ for undocumented insights
  6. Edits files and creates/updates a PR with traceability to source comments

Files

  • .claude/skills/enhance-claude-docs/SKILL.md — skill definition
  • .github/workflows/claude-docs-update.yml — GitHub Actions workflow

Test plan

  • Skill tested manually via /enhance-claude-docs 7 — full pipeline works end-to-end
  • Skill auto-discovered by Claude Code (confirmed in skills list)
  • Verify GitHub Actions workflow triggers correctly via workflow_dispatch after merge

🤖 Generated with Claude Code

@ninja-shreyash ninja-shreyash changed the title feat: enhance claude workflow docs: enhance Claude docs workflow + weekly PR review insights Apr 7, 2026
@ninja-shreyash ninja-shreyash force-pushed the sv/enhance-claude-workflow branch from a533672 to e4bd933 Compare April 7, 2026 08:15
@ninja-shreyash ninja-shreyash changed the title docs: enhance Claude docs workflow + weekly PR review insights feat: add enhance-claude-docs skill and weekly workflow Apr 7, 2026
@ninja-shreyash ninja-shreyash marked this pull request as ready for review April 7, 2026 09:02
@ninja-shreyash ninja-shreyash requested a review from a team April 7, 2026 09:02
Comment thread .github/workflows/claude-docs-update.yml
Comment thread .claude/skills/enhance-claude-docs/SKILL.md Outdated
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud bot commented Apr 7, 2026

@ninja-shreyash ninja-shreyash merged commit 8023fbe into main Apr 7, 2026
14 of 15 checks passed
@ninja-shreyash ninja-shreyash deleted the sv/enhance-claude-workflow branch April 7, 2026 17:14
@ninja-shreyash ninja-shreyash mentioned this pull request Apr 8, 2026
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.

3 participants