happier: Skill for Claude Code

.agents/skills/happier-github-ops/SKILL.md

happier-github-ops is a skill for Claude Code, Codex from happier-dev/happier. It costs 63 tokens per session (6,343 once invoked), scanned A, original, MIT.

A guide for reading and changing GitHub through Happier’s bot account, including issues, pull requests, and repository operations.

In plain words
What is it for?
Use it for approved GitHub reads and updates, bot-authenticated pushes, and safe handling of issue content.
Why use it?
It helps separate automated bot actions from a developer’s normal Git identity and handles the required authorization rules.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is happier-dev/happier's own configuration. It tells Claude Code and Codex how to work on happier itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything happier configures →

About the project

Happier is an open-source, end-to-end encrypted client that lets people run AI coding-agent sessions on a computer and continue controlling them from a phone, browser, or desktop app. It is for developers who use agents such as Claude Code, Codex, Gemini, or OpenCode across multiple devices, with self-hosting available. The catalogue entries are add-ons for configuring or extending this client and its supported coding-agent workflows.

happier-dev/happier · 2,072 stars · on GitHub · happier.dev

Reuse

Borrowing it

Nothing to install: this file belongs to happier-dev/happier. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/happier-dev/happier/dev/.agents/skills/happier-github-ops/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/happier-dev/happier

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for happier-github-ops

README.md
[![agentmods](https://agentmods.dev/badge/skills/happier-dev/happier/happier-github-ops/github.svg)](https://agentmods.dev/skills/happier-dev/happier/happier-github-ops)
Your own site
<a href="https://agentmods.dev/skills/happier-dev/happier/happier-github-ops"><img src="https://agentmods.dev/badge/skills/happier-dev/happier/happier-github-ops/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for happier-github-ops

Your own site · 80×15
<a href="https://agentmods.dev/skills/happier-dev/happier/happier-github-ops"><img src="https://agentmods.dev/badge/skills/happier-dev/happier/happier-github-ops.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,343 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 5 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Privilege Escalation · line 8
    Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.
    Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
  • high Privilege Escalation · line 125
    Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.
    Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
  • high Tool Misuse · line 145
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • medium Excessive Agency · line 70
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
  • medium Excessive Agency · line 72
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00063 $0.06343
Opus 5.5 $0.00025 $0.02537
Sonnet 5.5 $0.00013 $0.01269
Haiku 4.5 $0.00006 $0.00634

Measured 17d ago against content hash b326e42852d6, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

happier-github-ops scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 17d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/happier-github-ops/SKILL.md · 354 lines

How it starts

The opening of the file, as written. The whole thing — 354 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Happier GitHub Ops (bot gh wrapper)

This repo provides yarn ghops as the canonical isolated transport for GitHub API/UI reads and mutations as the bot, plus an explicit bot-authenticated branch-push capability. Ordinary commits and pushes still use the current machine's configured Git identity, remote, and credentials; ghops git push is an authorization-gated exception, never the default. ghops forces authentication via the bot Personal Access Token. HAPPIER_GITHUB_BOT_TOKEN has highest priority. Without that override, macOS reads the validated token from Keychain service happier/ghops, account happier-bot; a managed Linux workspace receives that same credential from the short-lived execution-host broker through its active mac-host target while keeping repository work on the authoritative Linux checkout. The broker exposes only this fixed credential over a user-only Unix socket and never places the token in the guest environment or on disk.

Prerequisites

  • gh is installed on the host and reachable on PATH.
  • Either environment variable HAPPIER_GITHUB_BOT_TOKEN is set to the bot's fine-grained PAT, or the token was stored on macOS with yarn ghops auth store.
  • Repository issue mutations require the fine-grained PAT permission Issues: Read and write for the target repository. The bot account's repository role and GraphQL viewerCanUpdate fields do not prove that the resolved token grants write operations.
  • Ordinary branch pushes require the current machine's normal Git credentials. An explicitly authorized bot push requires Contents: Read and write plus repository/fork permission to update the exact target branch; lack of machine access alone does not authorize that exception.

Contract / Safety

  • yarn ghops ... refuses to run if neither the environment override nor the macOS Keychain credential is available locally or through the active execution-host broker and mac-host target.
  • Runs non-interactively (GH_PROMPT_DISABLED=1).
  • Uses an isolated repo-local GH_CONFIG_DIR by default.
  • Never falls back to personal gh, GH_TOKEN, or GITHUB_TOKEN credentials.
  • Forces GH_HOST=github.com so an inherited host override cannot redirect the bot token.
  • auth store validates that the token belongs to happier-bot before persisting it.
  • Every ordinary invocation revalidates that the resolved token belongs to happier-bot before forwarding the requested command.

Read the full file on GitHub · 354 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 17d ago Changed · +2 lines b326e42852d6
  2. 1mo ago Changed 86d4ba63e413
  3. 1mo ago First seen · 352 lines · 63 tokens per session scan A 10d4561189c7

Subscribe to this mod's changes

happier-github-ops is a skill published in the GitHub repository happier-dev/happier (2,072 stars, last pushed yesterday), licensed MIT. It adds 63 tokens to every session and 6,343 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.