Files

T

Introduces a standalone skill installer script and project landing page
documentation covering all three skills in the repository.

install.sh:
- Downloads and installs SKILL.md files from the remote repository into
  the appropriate local directory for Claude Code (~/.claude/skills/) and/or
  Gemini CLI (~/.gemini/skills/)
- Supports --claude/-c and --gemini/-g flags to target one or both tools;
  defaults to both when neither is specified
- Accepts positional skill name arguments or --all/-a to install every
  available skill; named arguments always take precedence over --all
- Discovers available skills at runtime via the Gitea contents API, with
  automatic fallback to a depth-1 sparse git clone when the API is
  unreachable or returns no results; JSON parsing uses jq, then python3,
  then an awk fallback in order of availability
- Validates skill names against path traversal (../) and slash injection
  before any download is attempted
- Supports CLAUDE_SKILLS_DIR and GEMINI_SKILLS_DIR environment variable
  overrides for non-default install locations
- Checks for curl and git dependencies at startup and exits with a clear
  error listing any missing tools
- Cleans up any temporary clone directory on exit via a trap on EXIT
- Displays colorized output (Bold/Cyan headers, Green success, Yellow
  warnings, Red errors) when stdout is a terminal; disables all ANSI codes
  automatically when piped or redirected
- Includes a fully formatted --help/-h page documenting all flags,
  environment variables, and usage examples

README.md:
- Landing page covering project purpose, all three skills with per-skill
  purpose and execution protocol summaries, and a full Installation section
- Installation section documents the standard curl pipe form
  (curl -sL URL | bash -s -- args) with six ready-to-use one-liner examples
  covering all major flag combinations
- Flags & Options table, Environment Variables table, and a Manual Install
  section for users who prefer to inspect before running
- Table of contents with anchor links for all major sections
- License section referencing GPL-3.0-or-later

2026-05-13 21:53:56 -04:00

7.3 KiB

Raw Blame History

Rootiest Skills Repository

A collection of reusable AI skills (structured prompt protocols) for Claude Code and Gemini CLI. Each skill defines a precise execution protocol that guides the AI through complex, multi-step tasks — replacing ad-hoc prompting with consistent, auditable workflows.

Skills are plain Markdown files. The included install.sh script handles discovery and installation in a single command.

Skills
Installation
License

Skills

`systematic-enumeration`

Purpose: Eliminate counting and membership errors caused by the model's tendency toward holistic pattern recognition.

When invoked, the AI is required to work through three explicit phases:

Set Definition — enumerate every member of the finite set before any analysis begins.
Atomic Element Testing — test each item individually, producing a [Item] → [Logic] → [Boolean] record for every element. For character-level checks, the string is split into individual characters to bypass tokenization bias.
Reduction & Summation — aggregate results and self-verify that the number of items tested exactly matches the set size; if there is a mismatch, Phase 2 restarts.

Use when: counting characters in a string, verifying a property across a list of files or variables, or any membership test where a false negative carries real cost.

`git-publish-workflow`

Purpose: Automate the full lifecycle from uncommitted local work to an open Pull Request, with built-in quality gates.

The workflow runs three phases:

Scope Determination — if staged changes exist, operate only on those; otherwise operate on all modified/untracked files.
Safe-Commit Sequence — generate a kebab-case branch name, compose a Conventional Commits message, then run the project's primary test/lint/build command. If verification fails, the sequence stops — nothing is pushed.
Remote Integration — push the branch, open a PR against the default branch, and populate the description with a "Why/What" summary and a manual verification checklist (- [ ] items).

Use when: you say "Ship this," "Make a PR," or invoke /git-publish-workflow.

`readme-sync-audit`

Purpose: Keep README.md accurate by programmatically aligning it with the current state of the codebase.

Three-phase execution:

Delta Analysis — locate the last commit that touched README.md, diff all code changes from that point to HEAD, and extract undocumented environment variables, CLI flags, or API changes.
Pruning & Update Audit — remove stale setup steps or "Coming Soon" notes, correct version numbers and file paths, and synthesize documentation for newly discovered features.
Structural Integrity Check — verify that Quick Start commands still work, all config keys are listed, and code snippets match the current API.

Use when: you say "Update the docs," "Sync the README," or invoke /readme-sync-audit.

Installation

Quick Install (curl)

The intended usage is a single curl | bash command. The installer fetches and runs install.sh directly — no clone required.

Install all skills for both Claude Code and Gemini CLI:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all

Install all skills for Claude Code only:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all --claude

Install all skills for Gemini CLI only:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all --gemini

Install a single skill for both tools:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- systematic-enumeration

Install specific skills for Claude Code only:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --claude git-publish-workflow readme-sync-audit

Install specific skills for Gemini CLI only:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --gemini systematic-enumeration git-publish-workflow

Note: Providing explicit skill names alongside --all causes the named skills to take precedence — only those skills are installed.

Flags & Options

Flag	Description
`-c`, `--claude`	Install into Claude Code (`~/.claude/skills/`)
`-g`, `--gemini`	Install into Gemini CLI (`~/.gemini/skills/`)
`-a`, `--all`	Install every skill available in the repository
`SKILL...`	Install one or more named skills (positional arguments)
`-h`, `--help`	Show the help page

Tool targeting: if neither --claude nor --gemini is specified, the installer targets both tools by default.

Skill selection precedence: explicit skill names always override --all. Passing --all skill-name installs only skill-name, not every skill.

Dependencies: curl and git must be present on PATH. The installer checks for both and exits with a clear error if either is missing.

Environment Variables

Variable	Default	Description
`CLAUDE_SKILLS_DIR`	`~/.claude/skills`	Override the Claude Code install directory
`GEMINI_SKILLS_DIR`	`~/.gemini/skills`	Override the Gemini CLI install directory

Example — installing to a project-local skills directory:

curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh \
  | CLAUDE_SKILLS_DIR=./.claude/skills bash -s -- --claude systematic-enumeration

Examples

# Install everything, both tools (simplest possible invocation)
curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --all

# Install one skill, Claude only
curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --claude git-publish-workflow

# Install two skills, Gemini only
curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh | bash -s -- --gemini systematic-enumeration readme-sync-audit

# Override install directory, Claude only
curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh \
  | CLAUDE_SKILLS_DIR=~/my-skills bash -s -- --claude --all

Manual Install

If you prefer to inspect the script before running it:

# Download
curl -sL https://git.rootiest.dev/rootiest/ai-skills/raw/branch/main/install.sh -o install.sh

# Review
less install.sh

# Run
bash install.sh --all

Or clone the repository and run locally:

git clone https://git.rootiest.dev/rootiest/ai-skills.git
cd claude-skills
bash install.sh --all

License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

See LICENSE for the full license text, or visit https://www.gnu.org/licenses/gpl-3.0.html.

7.3 KiB Raw Blame History