forked from farhoodlabs/skills
Chris Farhood
7980dd06a0
SKILL.md instructions now clarify that GH_TOKEN must be used in the same shell invocation as the eval, with chained command examples. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
28 lines
1.4 KiB
Markdown
28 lines
1.4 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Overview
|
|
|
|
This is a **Claude Code skills repository**. Skills are reusable tools that extend Claude Code's capabilities. Each skill lives in its own top-level directory.
|
|
|
|
## Skill Structure
|
|
|
|
Each skill follows this convention:
|
|
- **`<skill-name>/SKILL.md`** — Required. Contains YAML frontmatter (`name`, `description`) and usage documentation. This is the entry point Claude Code reads when invoking the skill.
|
|
- **`<skill-name>/scripts/`** — Implementation scripts (bash). Scripts use `set -euo pipefail` and the `die()` pattern for error handling.
|
|
|
|
## Current Skills
|
|
|
|
- **`github-app-token`** — Generates short-lived GitHub App installation access tokens. Requires `GITHUB_APP_ID`, `GITHUB_APP_INSTALLATION_ID`, and `GITHUB_APP_PEM_FILE` env vars. The script outputs an `export GH_TOKEN=...` command meant to be `eval`'d by the caller.
|
|
|
|
## Key Patterns
|
|
|
|
- Scripts are pure bash with no external dependencies beyond standard Unix tools (`openssl`, `curl`, `jq`).
|
|
- The `eval` output pattern: scripts print shell commands to stdout (e.g., `export VAR="value"`) so callers can `eval` the output to set variables in their environment.
|
|
- The `die()` function prints errors to stderr and exits non-zero.
|
|
|
|
## No Build/Test/Lint System
|
|
|
|
There is no centralized build, test, or lint tooling. Each skill is self-contained.
|