Skip to content

Commit ea539ea

Browse files
aireillyaireilly
committed
Add skills list to docs-skills registry entry
The docs-skills plugin entry was missing its skills: list, causing the site to display "0 skills". Added all 49 skills from the repo and regenerated all artifacts. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> rh-pre-commit.version: 2.3.2 rh-pre-commit.check-secrets: ENABLED
1 parent c8dc6d3 commit ea539ea

58 files changed

Lines changed: 1434 additions & 4 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎catalog.md‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,58 @@ v0.3.0 | Apache-2.0 | [opendatahub-io/docs-skills](https://github.com/opendatahu
190190

191191
Tags: documentation, asciidoc, mkdocs, workflow, review, style-guide, jira, onboarding, code-analysis
192192

193+
| Skill | Description |
194+
|-------|-------------|
195+
| `/action-comments` | Fetch unresolved review comments from GitHub PRs or GitLab MRs and action them on local files |
196+
| `/article-extractor` | Download HTML from websites and extract article content, removing HTML bloat |
197+
| `/docs-convert-gdoc-md` | Read a Google Docs document, Google Slides presentation, or Google Sheets spreadsheet and output as Markdown or CSV |
198+
| `/docs-orchestrator` | Documentation workflow orchestrator that runs steps sequentially with progress state management |
199+
| `/docs-review-content-quality` | Review documentation for content quality — logical flow, scannability, conciseness, and customer focus |
200+
| `/docs-review-modular-docs` | Review AsciiDoc files for Red Hat modular documentation compliance |
201+
| `/docs-review-security` | Review documentation for security issues |
202+
| `/docs-review-style` | Multi-agent style guide and modular docs review with confidence scoring |
203+
| `/docs-review-technical` | Technical accuracy review and code-aware validation with confidence scoring |
204+
| `/docs-workflow-code-analysis` | Run code-learner analysis on a source repository for the docs orchestrator workflow |
205+
| `/docs-workflow-create-jira` | Create a linked JIRA ticket for documentation work |
206+
| `/docs-workflow-create-merge-request` | Commit, push, and create a merge request or pull request for documentation changes |
207+
| `/docs-workflow-jira-ready` | Check whether a JIRA query returns tickets ready for the docs workflow |
208+
| `/docs-workflow-pipeline-diagnostics` | Diagnose a docs-orchestrator pipeline run for failures, bottlenecks, and context-pressure risks |
209+
| `/docs-workflow-planning` | Create a documentation plan from requirements analysis output |
210+
| `/docs-workflow-pr-analysis` | Run PR/MR analysis for the docs orchestrator workflow |
211+
| `/docs-workflow-quality-gate` | Score documentation quality and intent alignment using LLM judge agents |
212+
| `/docs-workflow-requirements` | Analyze documentation requirements for a JIRA ticket using a two-pass fanout |
213+
| `/docs-workflow-scope-req-audit` | Classify JIRA requirements by code evidence status before planning |
214+
| `/docs-workflow-security-review` | Security and PII scan of documentation drafts before publication |
215+
| `/docs-workflow-start` | Interactive guided setup for the docs workflow |
216+
| `/docs-workflow-style-review` | Style guide compliance review of documentation drafts |
217+
| `/docs-workflow-tech-review` | Technical accuracy review of documentation drafts with optional code-learner validation |
218+
| `/docs-workflow-writing` | Write documentation from a documentation plan |
219+
| `/git-pr-reader` | Unified interface for GitHub PRs and GitLab MRs with file filtering, review comments, and diff extraction |
220+
| `/ibm-sg-audience-and-medium` | Review documentation for IBM Style Guide audience and medium issues |
221+
| `/ibm-sg-language-and-grammar` | Review documentation for IBM Style Guide language and grammar |
222+
| `/ibm-sg-legal-information` | Review documentation for IBM Style Guide legal issues |
223+
| `/ibm-sg-numbers-and-measurement` | Review documentation for IBM Style Guide number and measurement formatting |
224+
| `/ibm-sg-punctuation` | Review documentation for IBM Style Guide punctuation |
225+
| `/ibm-sg-references` | Review documentation for IBM Style Guide reference issues |
226+
| `/ibm-sg-structure-and-format` | Review documentation for IBM Style Guide structure and format |
227+
| `/ibm-sg-technical-elements` | Review documentation for IBM Style Guide technical elements |
228+
| `/jira-reader` | Read and analyze JIRA issues from Red Hat Issue Tracker |
229+
| `/jira-writer` | Update and modify JIRA issues on Red Hat Issue Tracker |
230+
| `/learn-code` | Analyze a codebase for engineer onboarding with module mapping and cross-module relationship discovery |
231+
| `/lint-with-vale` | Run Vale linting to check for style guide violations |
232+
| `/query-code` | Answer questions about a previously analyzed codebase using learn-code output |
233+
| `/redhat-docs-toc` | Extract distinct article URLs from Red Hat documentation table of contents pages |
234+
| `/rh-ssg-accessibility` | Review Red Hat documentation for accessibility compliance (WCAG) |
235+
| `/rh-ssg-formatting` | Review Red Hat documentation for SSG formatting compliance |
236+
| `/rh-ssg-grammar-and-language` | Review Red Hat documentation for SSG grammar and language compliance |
237+
| `/rh-ssg-gui-and-links` | Review Red Hat documentation for SSG graphical interface and link compliance |
238+
| `/rh-ssg-legal-and-support` | Review Red Hat documentation for SSG legal and support compliance |
239+
| `/rh-ssg-release-notes` | Review Red Hat release notes for SSG compliance |
240+
| `/rh-ssg-structure` | Review Red Hat documentation for SSG structural compliance |
241+
| `/rh-ssg-technical-examples` | Review Red Hat documentation for SSG technical example compliance |
242+
| `/rn-known-issues` | Check known issue status for a release version |
243+
| `/understand-pull-request` | Analyze a pull request or merge request and produce a PR-ANALYSIS.md document |
244+
193245
```bash
194246
/plugin install docs-skills@opendatahub-skills
195247
```

‎registry.yaml‎

Lines changed: 148 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -686,6 +686,154 @@ plugins:
686686
ref: main
687687
homepage: https://github.com/opendatahub-io/docs-skills
688688
repository: https://github.com/opendatahub-io/docs-skills
689+
skills:
690+
- name: action-comments
691+
description: Fetch unresolved review comments from GitHub PRs or GitLab MRs and action them on local files
692+
user-invocable: true
693+
- name: article-extractor
694+
description: Download HTML from websites and extract article content, removing HTML bloat
695+
user-invocable: true
696+
- name: docs-convert-gdoc-md
697+
description: Read a Google Docs document, Google Slides presentation, or Google Sheets spreadsheet and output as Markdown or CSV
698+
user-invocable: true
699+
- name: docs-orchestrator
700+
description: Documentation workflow orchestrator that runs steps sequentially with progress state management
701+
user-invocable: true
702+
- name: docs-review-content-quality
703+
description: Review documentation for content quality — logical flow, scannability, conciseness, and customer focus
704+
user-invocable: true
705+
- name: docs-review-modular-docs
706+
description: Review AsciiDoc files for Red Hat modular documentation compliance
707+
user-invocable: true
708+
- name: docs-review-security
709+
description: Review documentation for security issues
710+
user-invocable: true
711+
- name: docs-review-style
712+
description: Multi-agent style guide and modular docs review with confidence scoring
713+
user-invocable: true
714+
- name: docs-review-technical
715+
description: Technical accuracy review and code-aware validation with confidence scoring
716+
user-invocable: true
717+
- name: docs-workflow-code-analysis
718+
description: Run code-learner analysis on a source repository for the docs orchestrator workflow
719+
user-invocable: true
720+
- name: docs-workflow-create-jira
721+
description: Create a linked JIRA ticket for documentation work
722+
user-invocable: true
723+
- name: docs-workflow-create-merge-request
724+
description: Commit, push, and create a merge request or pull request for documentation changes
725+
user-invocable: true
726+
- name: docs-workflow-jira-ready
727+
description: Check whether a JIRA query returns tickets ready for the docs workflow
728+
user-invocable: true
729+
- name: docs-workflow-pipeline-diagnostics
730+
description: Diagnose a docs-orchestrator pipeline run for failures, bottlenecks, and context-pressure risks
731+
user-invocable: true
732+
- name: docs-workflow-planning
733+
description: Create a documentation plan from requirements analysis output
734+
user-invocable: true
735+
- name: docs-workflow-pr-analysis
736+
description: Run PR/MR analysis for the docs orchestrator workflow
737+
user-invocable: true
738+
- name: docs-workflow-quality-gate
739+
description: Score documentation quality and intent alignment using LLM judge agents
740+
user-invocable: true
741+
- name: docs-workflow-requirements
742+
description: Analyze documentation requirements for a JIRA ticket using a two-pass fanout
743+
user-invocable: true
744+
- name: docs-workflow-scope-req-audit
745+
description: Classify JIRA requirements by code evidence status before planning
746+
user-invocable: true
747+
- name: docs-workflow-security-review
748+
description: Security and PII scan of documentation drafts before publication
749+
user-invocable: true
750+
- name: docs-workflow-start
751+
description: Interactive guided setup for the docs workflow
752+
user-invocable: true
753+
- name: docs-workflow-style-review
754+
description: Style guide compliance review of documentation drafts
755+
user-invocable: true
756+
- name: docs-workflow-tech-review
757+
description: Technical accuracy review of documentation drafts with optional code-learner validation
758+
user-invocable: true
759+
- name: docs-workflow-writing
760+
description: Write documentation from a documentation plan
761+
user-invocable: true
762+
- name: git-pr-reader
763+
description: Unified interface for GitHub PRs and GitLab MRs with file filtering, review comments, and diff extraction
764+
user-invocable: true
765+
- name: ibm-sg-audience-and-medium
766+
description: Review documentation for IBM Style Guide audience and medium issues
767+
user-invocable: true
768+
- name: ibm-sg-language-and-grammar
769+
description: Review documentation for IBM Style Guide language and grammar
770+
user-invocable: true
771+
- name: ibm-sg-legal-information
772+
description: Review documentation for IBM Style Guide legal issues
773+
user-invocable: true
774+
- name: ibm-sg-numbers-and-measurement
775+
description: Review documentation for IBM Style Guide number and measurement formatting
776+
user-invocable: true
777+
- name: ibm-sg-punctuation
778+
description: Review documentation for IBM Style Guide punctuation
779+
user-invocable: true
780+
- name: ibm-sg-references
781+
description: Review documentation for IBM Style Guide reference issues
782+
user-invocable: true
783+
- name: ibm-sg-structure-and-format
784+
description: Review documentation for IBM Style Guide structure and format
785+
user-invocable: true
786+
- name: ibm-sg-technical-elements
787+
description: Review documentation for IBM Style Guide technical elements
788+
user-invocable: true
789+
- name: jira-reader
790+
description: Read and analyze JIRA issues from Red Hat Issue Tracker
791+
user-invocable: true
792+
- name: jira-writer
793+
description: Update and modify JIRA issues on Red Hat Issue Tracker
794+
user-invocable: true
795+
- name: learn-code
796+
description: Analyze a codebase for engineer onboarding with module mapping and cross-module relationship discovery
797+
user-invocable: true
798+
- name: lint-with-vale
799+
description: Run Vale linting to check for style guide violations
800+
user-invocable: true
801+
- name: query-code
802+
description: Answer questions about a previously analyzed codebase using learn-code output
803+
user-invocable: true
804+
- name: redhat-docs-toc
805+
description: Extract distinct article URLs from Red Hat documentation table of contents pages
806+
user-invocable: true
807+
- name: rh-ssg-accessibility
808+
description: Review Red Hat documentation for accessibility compliance (WCAG)
809+
user-invocable: true
810+
- name: rh-ssg-formatting
811+
description: Review Red Hat documentation for SSG formatting compliance
812+
user-invocable: true
813+
- name: rh-ssg-grammar-and-language
814+
description: Review Red Hat documentation for SSG grammar and language compliance
815+
user-invocable: true
816+
- name: rh-ssg-gui-and-links
817+
description: Review Red Hat documentation for SSG graphical interface and link compliance
818+
user-invocable: true
819+
- name: rh-ssg-legal-and-support
820+
description: Review Red Hat documentation for SSG legal and support compliance
821+
user-invocable: true
822+
- name: rh-ssg-release-notes
823+
description: Review Red Hat release notes for SSG compliance
824+
user-invocable: true
825+
- name: rh-ssg-structure
826+
description: Review Red Hat documentation for SSG structural compliance
827+
user-invocable: true
828+
- name: rh-ssg-technical-examples
829+
description: Review Red Hat documentation for SSG technical example compliance
830+
user-invocable: true
831+
- name: rn-known-issues
832+
description: Check known issue status for a release version
833+
user-invocable: true
834+
- name: understand-pull-request
835+
description: Analyze a pull request or merge request and produce a PR-ANALYSIS.md document
836+
user-invocable: true
689837
harnesses:
690838
claude-code:
691839
install: "/plugin install docs-skills@opendatahub-skills"

‎site/docs/categories/documentation.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,4 +21,4 @@ Autonomous knowledge management skills for keeping AI context files (CLAUDE.md,
2121

2222
Documentation review, writing, and workflow tools for AsciiDoc and Markdown documentation. Includes an orchestrated multi-step pipeline, standalone review skills, codebase analysis for onboarding, and JIRA/PR integration.
2323

24-
**0 skills** - v0.3.0
24+
**49 skills** - v0.3.0

‎site/docs/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ hide:
1010

1111
# Skills and plugins for AI-assisted software engineering workflows
1212

13-
14 plugins | 75 skills | 7 categories
13+
14 plugins | 124 skills | 7 categories
1414

1515
[Getting Started](getting-started.md){ .md-button .md-button--primary }
1616

@@ -114,7 +114,7 @@ hide:
114114

115115
Documentation review, writing, and workflow tools for AsciiDoc and Markdown documentation. Includes an orchestrated m...
116116

117-
**0 skills** - Documentation - v0.3.0
117+
**49 skills** - Documentation - v0.3.0
118118

119119
</div>
120120

0 commit comments

Comments
 (0)