2 Commits

Author SHA1 Message Date
rootiest 80cdf75de2 fix(install): use subdirectory layout for installed skills
Both Claude Code and Gemini CLI expect skills at:
  <skills-dir>/<skill-name>/SKILL.md

rather than the flat:
  <skills-dir>/<skill-name>.md

Update install_to_claude and install_to_gemini to create the skill
subdirectory and write the file as SKILL.md within it.
2026-05-13 22:02:40 -04:00
rootiest 20a811aca0 feat: add install.sh and README.md
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