AI agents & automation

skit is a script repository for humans and AI agents: one library — you get the TUI, agents get a deterministic CLI.

Install the Agent Skill

The official Agent Skill teaches compatible agents (Claude Code, Codex, Cursor, Gemini CLI, and many more) how to drive your library:

skit agent install            # use the sole detected agent directory; otherwise, select one
skit agent install claude     # select claude / codex / agents (--project limits it to this repo)
npx skills add t41372/skit    # or install through skills.sh into 70+ agents

The bare command uses an agent directory only when it finds exactly one supported directory. If it finds none or more than one, select claude, codex, or agents, or use --to DIR. This rule prevents skit from creating an agent directory that you did not select.

What the skill teaches

• Check the library first (skit list) before writing yet another one-off script — it may already exist.
• Inspect before running: skit show <name> --json returns the entry's full parameter schema, machine-readable.
• Run deterministically: skit run <name> --set key=value --no-input.
• Offer to save the useful scripts it writes — with your OK — so they outlive the session that created them.

The CLI contract

Every launch-menu action is also a CLI command, built to be driven by machines:

• --json output on every listing and inspection command — skit show --json returns a stable per-parameter schema (types, defaults, delivers_empty, secret marking, choices) documented in the CLI reference.
• Meaningful exit codes, docker-convention: skit run passes the script's own exit code through untouched; skit's own errors use 125/126/127, 130 means the user cancelled, and signal death reports as 128+N — full table in the CLI reference.
• Deterministic value resolution: --set → preset → last-used → declared default. An unknown parameter name exits 2; a bad value exits 125.
• --no-input never prompts and never guesses — if information is missing, skit fails fast with a named error instead of silently assembling a broken command.
• --dry-run prints the exact command that would run, without running it.

skit list --json              # machine-readable listing
skit show my_script --json    # full parameter schema
skit run my_script --set width=800 --no-input
skit run my_script --dry-run