Add human-focused README.md to every skill and bundle directory

Each README is written for a human audience, explaining:
- What the skill does (not what format it follows)
- What benefit the user gets from installing it
- Quick setup and usage patterns
- When to load/trigger the skill
- What scripts, references, and templates it ships

data-scientist already had a README — left unchanged.

48 READMEs added across all skill and bundle directories.
This commit is contained in:
Magnus Hedemark
2026-07-09 22:30:12 -04:00
parent 6c193ae2d8
commit 738ec715e7
48 changed files with 1561 additions and 0 deletions
+34
View File
@@ -0,0 +1,34 @@
# Forgejo / Gitea CLI — Self-Hosted Git Forge
Manage issues, pull requests, repositories, labels, webhooks, and Actions runners on a self-hosted Forgejo or Gitea instance — all from the terminal.
## Why Install This Skill
When your agent loads this skill, it can **manage your entire self-hosted Git forge** without a browser. That means:
- **List, create, and search repositories** — manage your code hosting
- **Handle issues** — list, show, create, comment, label, assign
- **Manage pull requests** — list, diff, review, comment, merge with branch protection
- **Configure webhooks** — list, create, delete
- **Manage labels** — list and create custom labels
## What You Get
| Directory | Purpose |
|-----------|---------|
| `SKILL.md` | Complete command reference with authentication setup and examples |
| `scripts/forgejo-cli` | Python CLI tool |
## Quick Start
Two token profiles in `~/.hermes/.env`:
- `FORGEJO_AGENT_TOKEN` — for automated operations (default)
- `FORGEJO_USER_TOKEN` — for user-level operations (`--user` flag)
## Triggers
Load this when dealing with Forgejo, Gitea, self-hosted git forges, or any repository management on your own infrastructure.
## Requirements
Python 3.8+ with `requests` library. Self-hosted Forgejo or Gitea instance.