OpenParable
Skip to content
← Back to skills

Happier Github Ops

Apps & Automation
happier-github-ops

Happier Github Ops is an Agent Skill for apps & automation published in the happier-dev/happier repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run GitHub CLI commands as the Happier bot account via `yarn ghops` (forced PAT auth + non-interactive).

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/happier-dev/happier/blob/HEAD/skills/happier-github-ops/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/happier-github-ops, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Happier GitHub Ops (bot gh wrapper)

This repo provides yarn ghops as a thin wrapper around the GitHub CLI (gh) that forces authentication via the bot Personal Access Token.

Prerequisites

  • gh is installed on the host and reachable on PATH.
  • Environment variable HAPPIER_GITHUB_BOT_TOKEN is set to the bot's fine-grained PAT.

Contract / Safety

  • yarn ghops ... refuses to run if HAPPIER_GITHUB_BOT_TOKEN is missing.
  • Runs non-interactively (GH_PROMPT_DISABLED=1).
  • Uses an isolated repo-local GH_CONFIG_DIR by default.

What to write (LLM guidelines)

When creating/updating public issues, keep it useful but minimal:

  • Prefer user impact, repro steps, expected vs actual, and acceptance criteria.
  • Link to PRs/commits by URL when available.
  • Avoid internal-only detail: no private logs, no secrets, no tokens, and no stack dumps from private environments.
  • If you need to share sensitive debugging context, summarize it and keep the raw detail local.

Suggested comment format for progress updates:

  • What changed (1–3 bullets)
  • Why (brief)
  • Next step / what’s blocked (one line)
  • Links (PR/commit/issues)

Common commands

Verify identity (must be the bot user):

yarn ghops api user

Project conventions (Happier roadmap)

Canonical public roadmap project:

  • Owner: happier-dev
  • Project number: 1
  • URL: https://github.com/orgs/happier-dev/projects/1

Labels (conventions)

These labels are intended to keep the public roadmap curated and consistent:

  • roadmap (triage-owned): include this item on the public roadmap project
  • priority:p0, priority:p1, priority:p2, priority:p3 (triage-owned)
  • stage:not-shipped, stage:experimental, stage:beta, stage:ga (optional; rollout state)
  • type: bug, type: feature, type: task (recommended)
  • source: bug-report (applied automatically by the bug-report service)

When asked to “create an issue and put it on the roadmap with P0”, do:

  1. Create the issue
  2. Apply roadmap and priority:p0 (and a type:* label)
  3. Ensure it lands on the roadmap project (automation should add it; if not, add explicitly)

When you create or meaningfully update an issue/PR, ensure it’s visible on the roadmap:

  • Prefer GitHub Project automation (auto-add when roadmap label is present).
  • If you’re not sure it will be auto-added, explicitly add it:
yarn ghops project item-add 1 --owner happier-dev --url https://github.com/happier-dev/happier/issues/123

Create an issue (repo explicit is recommended):

yarn ghops issue create -R happier-dev/happier --title "..." --body "..." --label "type: bug"

For CLI-created issues, format the body like the templates:

  • Bug: summary + what happened + expected behavior + (optional) repro + (optional) frequency/severity + (optional) environment
  • Feature: problem + proposal + acceptance criteria

For scripting / machine-readable output, prefer gh api:

yarn ghops api repos/happier-dev/happier/issues \
  -f title="..." \
  -f body="..." \
  --jq '{number: .number, url: .html_url}'

Comment on an issue:

yarn ghops api repos/happier-dev/happier/issues/123/comments -f body="Update: ..."

Apply labels (example):

yarn ghops api repos/happier-dev/happier/issues/123/labels -f labels[]="roadmap" -f labels[]="priority:p0"

Titles (guidelines)

Prefer short, descriptive titles without noisy prefixes:

  • Good: Sessions flicker online/inactive
  • Good: CLI: doctor fails when daemon is stopped
  • Avoid: P0: ... (priority belongs in the project/labels, not the title)
  • Avoid: long bracket stacks like [Bug][iOS][P0] ...

Add an issue/PR to the org project (Project v2):

yarn ghops project item-add 1 --owner happier-dev --url https://github.com/happier-dev/happier/issues/123

List project fields/items (JSON):

yarn ghops project field-list 1 --owner happier-dev --format json
yarn ghops project item-list 1 --owner happier-dev --format json