Skip to content

Commit 58859cb

Browse files
aireillyaireilly
committed
Add missing docs-skills skill descriptions
rh-pre-commit.version: 2.3.2 rh-pre-commit.check-secrets: ENABLED
1 parent 26e3ec3 commit 58859cb

1 file changed

Lines changed: 149 additions & 0 deletions

File tree

‎registry.yaml‎

Lines changed: 149 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -684,8 +684,157 @@ plugins:
684684
type: github
685685
repo: opendatahub-io/docs-skills
686686
ref: main
687+
strict: false
687688
homepage: https://github.com/opendatahub-io/docs-skills
688689
repository: https://github.com/opendatahub-io/docs-skills
690+
skills:
691+
- name: action-comments
692+
description: Fetch unresolved review comments from GitHub PRs or GitLab MRs and interactively action them on local files
693+
user-invocable: true
694+
- name: article-extractor
695+
description: Download HTML from websites and extract article content from documentation sites like Red Hat docs
696+
user-invocable: true
697+
- name: docs-convert-gdoc-md
698+
description: Read a Google Docs document, Google Slides presentation, or Google Sheets spreadsheet and output as Markdown or CSV
699+
user-invocable: true
700+
- name: docs-orchestrator
701+
description: Documentation workflow orchestrator that runs steps sequentially from a workflow YAML, manages progress state, and handles iteration gates
702+
user-invocable: true
703+
- name: docs-review-content-quality
704+
description: Review documentation for content quality — logical flow, scannability, conciseness, fluff removal, and customer focus
705+
user-invocable: true
706+
- name: docs-review-modular-docs
707+
description: Review AsciiDoc files for Red Hat modular documentation compliance — module types, assembly structure, anchor IDs, and context variables
708+
user-invocable: true
709+
- name: docs-review-security
710+
description: Scan documentation for sensitive data before publication — real IP addresses, credentials, internal hostnames, and PII
711+
user-invocable: true
712+
- name: docs-review-style
713+
description: Multi-agent style guide and modular docs review with confidence scoring, supporting local branch and PR/MR review
714+
user-invocable: true
715+
- name: docs-review-technical
716+
description: Technical accuracy review and code-aware validation with confidence scoring for documentation against source code
717+
user-invocable: true
718+
- name: docs-workflow-code-analysis
719+
description: Run code-learner analysis on a source repository for the docs orchestrator workflow
720+
user-invocable: true
721+
- name: docs-workflow-create-jira
722+
description: Create a linked JIRA ticket for documentation work using direct JIRA REST API calls
723+
user-invocable: true
724+
- name: docs-workflow-create-merge-request
725+
description: Commit, push, and create a merge request (GitLab) or pull request (GitHub) for documentation changes
726+
user-invocable: true
727+
- name: docs-workflow-jira-ready
728+
description: Check whether a JIRA query returns tickets ready for the docs workflow
729+
user-invocable: true
730+
- name: docs-workflow-pipeline-diagnostics
731+
description: Diagnose a docs-orchestrator pipeline run for failures, bottlenecks, and context-pressure risks
732+
user-invocable: true
733+
- name: docs-workflow-planning
734+
description: Create a documentation plan from requirements analysis output via the docs-planner agent
735+
user-invocable: true
736+
- name: docs-workflow-pr-analysis
737+
description: Run PR/MR analysis for the docs orchestrator workflow via the understand-pull-request subagent
738+
user-invocable: true
739+
- name: docs-workflow-quality-gate
740+
description: Score documentation quality and intent alignment using LLM judge agents with pass/fail gate
741+
user-invocable: true
742+
- name: docs-workflow-requirements
743+
description: Analyze documentation requirements for a JIRA ticket using a two-pass fanout with per-requirement deep analysis
744+
user-invocable: true
745+
- name: docs-workflow-scope-req-audit
746+
description: Classify JIRA requirements by code evidence status before planning to prevent hallucinated documentation
747+
user-invocable: true
748+
- name: docs-workflow-security-review
749+
description: Security and PII scan of documentation drafts before publication using deterministic scanner and agent analysis
750+
user-invocable: true
751+
- name: docs-workflow-start
752+
description: Interactive guided setup for the docs workflow with support for full workflow, individual steps, and resuming previous runs
753+
user-invocable: true
754+
- name: docs-workflow-style-review
755+
description: Style guide compliance review of documentation drafts with Vale linting and 18+ style guide review skills
756+
user-invocable: true
757+
- name: docs-workflow-tech-review
758+
description: Technical accuracy review of documentation drafts with optional code-learner validation
759+
user-invocable: true
760+
- name: docs-workflow-writing
761+
description: Write documentation from a documentation plan, supporting AsciiDoc and MkDocs formats with fix mode
762+
user-invocable: true
763+
- name: git-pr-reader
764+
description: Unified interface for GitHub PRs and GitLab MRs — read data, list changed files, get and post review comments, and get unified diffs
765+
user-invocable: true
766+
- name: ibm-sg-audience-and-medium
767+
description: Review documentation for IBM Style Guide audience and medium issues — accessibility, global audience, tone, and AI assistant style
768+
user-invocable: true
769+
- name: ibm-sg-language-and-grammar
770+
description: Review documentation for IBM Style Guide language and grammar — abbreviations, capitalization, active voice, and inclusive language
771+
user-invocable: true
772+
- name: ibm-sg-legal-information
773+
description: Review documentation for IBM Style Guide legal issues — unsubstantiated claims, trademarks, copyright, and PII in examples
774+
user-invocable: true
775+
- name: ibm-sg-numbers-and-measurement
776+
description: Review documentation for IBM Style Guide number and measurement formatting — numerals, currency, dates, time, and units
777+
user-invocable: true
778+
- name: ibm-sg-punctuation
779+
description: Review documentation for IBM Style Guide punctuation — serial commas, dashes, hyphens, quotation marks, and list punctuation
780+
user-invocable: true
781+
- name: ibm-sg-references
782+
description: Review documentation for IBM Style Guide reference issues — citations, product names, version formatting, and geographic references
783+
user-invocable: true
784+
- name: ibm-sg-structure-and-format
785+
description: Review documentation for IBM Style Guide structure — headings, lists, procedures, tables, notes, and formatting conventions
786+
user-invocable: true
787+
- name: ibm-sg-technical-elements
788+
description: Review documentation for IBM Style Guide technical elements — code examples, CLI formatting, UI elements, and keyboard shortcuts
789+
user-invocable: true
790+
- name: jira-reader
791+
description: Read and analyze JIRA issues from Red Hat Issue Tracker — fetch details, search, extract comments, traverse ticket graphs, and generate summaries
792+
user-invocable: true
793+
- name: jira-writer
794+
description: Update and modify JIRA issues on Red Hat Issue Tracker — push release notes, update custom fields, and manage labels
795+
user-invocable: true
796+
- name: learn-code
797+
description: Analyze a codebase for engineer onboarding — detect language, map modules, analyze in parallel, and produce an ONBOARDING.md guide
798+
user-invocable: true
799+
- name: lint-with-vale
800+
description: Run Vale linting to check for style guide violations in Markdown, AsciiDoc, reStructuredText, HTML, XML, and source code comments
801+
user-invocable: true
802+
- name: query-code
803+
description: Answer questions about a previously analyzed codebase using learn-code output and source code inspection
804+
user-invocable: true
805+
- name: redhat-docs-toc
806+
description: Extract distinct article URLs from Red Hat documentation table of contents pages for crawling multi-page docs
807+
user-invocable: true
808+
- name: rh-ssg-accessibility
809+
description: Review Red Hat documentation for WCAG accessibility compliance — alt text, color usage, directional language, link text, and heading nesting
810+
user-invocable: true
811+
- name: rh-ssg-formatting
812+
description: Review Red Hat documentation for SSG formatting — code blocks, user-replaced values, title capitalization, product attributes, and date formats
813+
user-invocable: true
814+
- name: rh-ssg-grammar-and-language
815+
description: Review Red Hat documentation for SSG grammar — conscious language, contractions, minimalism, and homograph avoidance
816+
user-invocable: true
817+
- name: rh-ssg-gui-and-links
818+
description: Review Red Hat documentation for SSG GUI and link compliance — UI element formatting, cross-references, external links, and URL formatting
819+
user-invocable: true
820+
- name: rh-ssg-legal-and-support
821+
description: Review Red Hat documentation for SSG legal compliance — cost references, future release promises, and Technology/Developer Preview requirements
822+
user-invocable: true
823+
- name: rh-ssg-release-notes
824+
description: Review Red Hat release notes for SSG compliance — tense, headings, Jira references, and release note type formatting
825+
user-invocable: true
826+
- name: rh-ssg-structure
827+
description: Review Red Hat documentation for SSG structural compliance — admonitions, lead-in sentences, prerequisites, and short descriptions
828+
user-invocable: true
829+
- name: rh-ssg-technical-examples
830+
description: Review Red Hat documentation for SSG technical examples — root privilege commands, YAML, IP/MAC addresses, and code block quality
831+
user-invocable: true
832+
- name: rn-known-issues
833+
description: Check known issue status for a release version — identify open vs resolved known issues for release notes
834+
user-invocable: true
835+
- name: understand-pull-request
836+
description: Analyze a pull request or merge request — fetch metadata, identify affected modules, and produce a PR-ANALYSIS.md document
837+
user-invocable: true
689838
harnesses:
690839
claude-code:
691840
install: "/plugin install docs-skills@opendatahub-skills"

0 commit comments

Comments
 (0)