Add RHDH Users Skill Pack

Agent Skills for adopting and using Red Hat Developer Hub, starting with skill-maker for creating and auditing Agent Skills. Install via `npx skills add redhat-developer/rhdh-users-skill-pack`.

Author: 04kash

.githooks/pre-commit

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Auto-installed via core.hooksPath — no `pre-commit install` needed.
+# See .pre-commit-config.yaml for hook definitions.
+
+if command -v pre-commit &>/dev/null; then
+  pre-commit run --hook-stage pre-commit "${@}"
+else
+  echo "⚠ pre-commit not installed — skipping hooks."
+  echo "  Install: pip install pre-commit  (or: uv tool install pre-commit)"
+fi

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# Default owners for the RHDH Users Skill Pack.
+# Review from a code owner is required before merging pull requests.
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+* @redhat-developer/rhdh-cope

.github/workflows/ci.yml

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  resolve-python:
+    runs-on: ubuntu-latest
+    outputs:
+      min-version: ${{ steps.resolve.outputs.min }}
+      max-version: ${{ steps.resolve.outputs.max }}
+      matrix: ${{ steps.resolve.outputs.matrix }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - id: resolve
+        run: |
+          python3 << 'PYEOF' >> "$GITHUB_OUTPUT"
+          import re, json
+          with open('pyproject.toml') as f:
+              spec = re.search(r'requires-python\s*=\s*"([^"]+)"', f.read())
+          spec = spec.group(1) if spec else '>=3.9'
+          min_m = re.search(r'>=\s*([\d.]+)', spec)
+          max_m = re.search(r'<=?\s*([\d.]+)', spec)
+          min_v = min_m.group(1) if min_m else '3.9'
+          max_v = max_m.group(1) if max_m else '3.x'
+          matrix = [min_v, max_v] if min_v != max_v else [min_v]
+          print(f'min={min_v}')
+          print(f'max={max_v}')
+          print(f'matrix={json.dumps(matrix)}')
+          PYEOF
+
+  lint:
+    needs: resolve-python
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ needs.resolve-python.outputs.max-version }}
+
+      - run: uv sync --frozen --extra dev
+
+      - run: uv run ruff check .
+
+      - run: uv run ruff format --check .
+
+  test:
+    needs: resolve-python
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ${{ fromJson(needs.resolve-python.outputs.matrix) }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - run: uv sync --frozen --extra dev
+
+      - run: uv run pytest -v

.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# OAuth credentials
+client_secret*.json
+
+# uv
+.python-version
+
+# Local config (project-specific settings)
+.rhdh/
+.rhdh-plugin/
+
+# Personal workspace wrapper (not part of the skill repo)
+rhdh-local-setup/
+
+# Temporary testing checkouts
+tmp/

.markdownlint.json

@@ -0,0 +1,13 @@
+{
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD024": {
+    "siblings_only": true
+  },
+  "MD029": false,
+  "MD036": false,
+  "MD040": false,
+  "MD055": false,
+  "MD056": false
+}

.pre-commit-config.yaml

@@ -0,0 +1,54 @@
+repos:
+  # Python linting and formatting
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.10
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        args: ['--allow-multiple-documents']
+      - id: check-toml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-merge-conflict
+      - id: check-json
+
+  # Markdown linting
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.17.2
+    hooks:
+      - id: markdownlint-cli2
+        args: ["--fix"]
+        exclude: ^\.planning/
+
+  # Secret detection
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.24.2
+    hooks:
+      - id: gitleaks
+
+  # Shell script linting
+  - repo: https://github.com/shellcheck-py/shellcheck-py
+    rev: v0.10.0.1
+    hooks:
+      - id: shellcheck
+        args: ["--severity=warning"]
+
+  # Run tests before commit
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: uv run pytest tests/ -q
+        language: system
+        types: [python]
+        pass_filenames: false
+        stages: [pre-commit]

AGENTS.md

@@ -0,0 +1,73 @@
+# AGENTS.md
+
+Agent Skills for Red Hat Developer Hub (RHDH) users. Skills follow the [Agent Skills open standard](https://agentskills.io/specification).
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them — don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Bundled Python scripts should prefer the standard library. Avoid new runtime dependencies unless clearly justified.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it — don't delete it.
+
+When your changes create orphans:
+
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: every changed line should trace directly to what was asked.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+Run `uv run pytest` before reporting any task complete. Do not report completion based on code existing — verify it works.
+
+## 5. No Irreversible Commands Without Confirmation
+
+Never force push, reset HEAD, merge branches, or run destructive commands without asking. If unsure whether a command is destructive, ask.
+
+## 6. Learn From Corrections
+
+If told an implementation was wrong, apply the correction and then record what went wrong so the same mistake is not repeated. Patterns and gotchas specific to this project belong in the relevant `references/` file under each skill.
+
+---
+
+## Available skills
+
+User-facing skills live under `skills/`:
+
+- `skill-maker` — Create, audit, and consolidate Agent Skills
+
+When adding a skill, update [README.md](./README.md) and keep `SKILL.md` `name` aligned with the directory name per the Agent Skills spec.

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing to RHDH Users Skill Pack
+
+Thank you for helping improve Agent Skills for Red Hat Developer Hub users.
+
+This project is released under the Apache-2.0 License.
+
+## What belongs in this repository
+
+This pack is for skills that help people **use and extend RHDH**. Skills aimed at Red Hat internal engineering (Jira automation, release trains, internal CI) belong in [`redhat-developer/rhdh-skill`](https://github.com/redhat-developer/rhdh-skill), not here.
+
+The pack currently ships `skill-maker` for authoring new skills. Additional user-facing skills are welcome as focused contributions.
+
+## Get started
+
+```bash
+git clone https://github.com/redhat-developer/rhdh-users-skill-pack.git
+cd rhdh-users-skill-pack
+uv sync --extra dev
+git config core.hooksPath .githooks
+```
+
+The `core.hooksPath` setting enables the checked-in pre-commit hook (lint + tests). No separate `pre-commit install` is required.
+
+### Run tests
+
+```bash
+uv run pytest
+```
+
+### Lint
+
+```bash
+uv run ruff check .
+uv run ruff format --check .
+```
+
+Both run automatically via the pre-commit hook when `pre-commit` is installed.
+
+## Adding or changing a skill
+
+1. Follow the [Agent Skills specification](https://agentskills.io/specification).
+2. Place the skill at `skills/<name>/` where `<name>` matches the `name` field in `SKILL.md` front matter.
+3. Keep `SKILL.md` focused; put detailed guidance in `references/`, scripts in `scripts/`, and examples in `assets/`.
+4. Prefer **stdlib-only Python** for bundled scripts unless a dependency is clearly justified.
+5. Update the skills table in [README.md](./README.md) when adding a new skill.
+6. Add or update tests under `tests/` when changing scripts or validation logic.
+
+Use the bundled `skill-maker` skill to interview, draft, and audit new skills before opening a PR.
+
+## Submitting a pull request
+
+1. Fork the repository and create a branch from `main`.
+2. Make focused commits — one concern per commit when practical.
+3. Ensure `uv run pytest` and `uv run ruff check .` pass.
+4. Open a pull request with:
+   - What user problem the change solves
+   - How you tested it
+   - Any new prerequisites users should know about
+
+## Reporting issues
+
+Use [GitHub Issues](https://github.com/redhat-developer/rhdh-users-skill-pack/issues) for bugs, missing workflows, and skill ideas. Include your RHDH version, agent tool, and the prompt or task that did not work as expected.
+
+## Code of conduct
+
+Be respectful and constructive. This is a public Red Hat Developer project intended for a broad community of RHDH users.