Files

T

Chris Farhood 7980dd06a0 docs: add CLAUDE.md and fix SKILL.md for cross-invocation shell usage

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>

2026-03-26 22:32:12 -04:00

1.4 KiB

Raw Blame History

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.

1.4 KiB Raw Blame History