Configuration

Per-Skill Config Files

Each skill has a config.sh file in skills/<name>/config.sh that defines:

SKILL_NAME="agnosticd"
UPSTREAM_REPO="https://github.com/agnosticd/agnosticd-v2"
FORK_REPO=""                    # optional override
BRANCH="main"
DOC_PATHS=(
    "docs/setup.adoc"
    "docs/contributing.adoc"
    "README.adoc"
)

Fields

Field Required Description
SKILL_NAME Yes Identifier matching the directory name
UPSTREAM_REPO Yes Primary source repository URL
FORK_REPO No Fork URL; used instead of upstream if set
BRANCH Yes Git branch to fetch from
DOC_PATHS Yes Array of file paths to copy into references/

Using a Fork

To use a fork instead of the upstream repository, set FORK_REPO in the skill’s config.sh:

FORK_REPO="https://github.com/your-username/agnosticd-v2"

The installer uses FORK_REPO when set, falling back to UPSTREAM_REPO.

Registry

The registry at ~/.rhel-devops-skills/registry.json tracks:

  • Installed skills and their source repositories
  • Commit hash at install/update time
  • Which IDEs each skill is installed to
  • Whether automatic update checking is enabled

Registry Location

Override with the RHEL_DEVOPS_SKILLS_HOME environment variable:

export RHEL_DEVOPS_SKILLS_HOME=/custom/path
./install.sh install --all

Cursor Rules

When installing to Cursor, .mdc rule files from skills/<name>/rules/ are copied to .cursor/rules/ in the current project. Rules use glob patterns to activate only on relevant files:

---
description: AgnosticD v2 conventions
globs: ["**/configs/**/*", "**/roles/**/tasks/*.yml"]
alwaysApply: false
---

Installation Paths

The installer supports three target paths, controlled by the --ide flag:

--ide value Path Compatible tools
claude ~/.claude/skills/<name>/ Claude Code
cursor ~/.cursor/skills/<name>/ Cursor IDE
agents ~/.agents/skills/<name>/ Codex, Copilot, Cursor, Goose, Gemini CLI, and 40+ Agent Skills standard tools
both Claude + Cursor (auto-detect)  
all Claude + Cursor + agents All of the above

The agents path follows the Agent Skills open standard portable directory convention. Skills installed there use the same SKILL.md + references/ format but are discoverable by any compliant tool.