tkersey/yo
codex/skills/yo/SKILL.md
Publish provided content to a secret GitHub gist bucket and surface it to a human via a local macOS notification that opens the gist when tapped. Use when Codex needs to show or notify a human with raw text or file content, wants a gist-backed human handoff, or is explicitly invoked as `$yo`. YO accepts inline text or file paths, creates or reuses a repo-scoped secret gist, and notifies through macOS Notification Center.
$ install --global
skillsauthnpx skillsauth add tkersey/dotfiles yoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 3:27 AM39.4s3 files scanned
SKILL.md
- name:
- yo
- description:
- Publish provided content to a secret GitHub gist bucket and surface it to a human via a local macOS notification that opens the gist when tapped. Use when Codex needs to show or notify a human with raw text or file content, wants a gist-backed human handoff, or is explicitly invoked as `$yo`. YO accepts inline text or file paths, creates or reuses a repo-scoped secret gist, and notifies through macOS Notification Center.
YO
Workflow
- Decide whether the request clearly asks to show or notify a human. If it does not, do not use YO implicitly.
- Gather the payload as either:
- inline text
- a file path whose contents should be published
- Run the helper:
uv run python codex/skills/yo/scripts/publish_notify.py --text "..."for inline contentuv run python codex/skills/yo/scripts/publish_notify.py --file path/to/content.mdfor file-backed content- Add
--title "..."only when the caller already knows the exact notification title - Add
--dry-runwhen you need proof without side effects
- Treat the helper's JSON as the source of truth:
status=delivered: gist publish + notification succeededstatus=partial: gist publish succeeded, notification failed after one retrystatus=dry_run: no side effects; inspectrepo_label,file_name,preview, andbucket_actionstatus=dropped: GitHub gist capability was unavailable; do not fall back to notification-only deliverystatus=failed: invalid input, non-macOS execution, gist mutation failure, or another visible error
Output Contract
- Publish into a secret gist only. Never use public gist mode.
- Reuse a stable gist bucket per repo label:
originremote first- first remote second
no-repowhen no parseable remote exists
- Keep one markdown file per delivery inside that bucket.
- Preserve the original body verbatim below the helper's minimal metadata header.
- Include the literal gist URL in the notification body.
- Open the gist when the human taps the notification.
- Stay silent by default. Do not add sound.
- Fail closed on non-macOS platforms.
- If GitHub auth or
gistscope is unavailable, accept the helper'sdroppedresult and stop quietly instead of inventing a fallback. - If
terminal-notifieris unavailable, fail visibly instead of falling back to a non-clickable notifier.
Constraints
- Use only
ghplusterminal-notifierfor live behavior. - Do not rewrite, summarize, or polish the payload.
- Do not trigger from generic escalation or handoff language alone; the request must clearly aim to show or notify a human.
Examples
Use $yo to send this handoff note to the human.Show this markdown to a human with a local macOS notification.Notify the human locally and include a gist link for this release summary.
Related Skills
tkersey/invariant-stewardship
testing
VerifiedTrustedCommunity
Use before local patching when bugs, regressions, malformed state, crashes, parser failures, migrations, cache drift, protocol problems, compatibility requests, tolerant readers, fallbacks, coercions, retries, catch-and-continue logic, or local workarounds may broaden accepted invalid state.
60SKILL.mdUpdated Jun 9, 2026
tkersey/evidence-discipline
testing
VerifiedTrustedCommunity
Use for bug reports, PR/issue prose, reviewer comments, user diagnoses, generated summaries, memories, retrieved context, public tracker context, claimed root causes, proposed fixes, fake-minimal repro risk, or any investigation where natural-language context could anchor the implementation scope.
60SKILL.mdUpdated Jun 9, 2026
tkersey/doctrine-compiler
development
VerifiedTrustedCommunity
Use when non-trivial work needs Challenge Escalation, latent-intelligence activation, frame-market selection, doctrine operators, dominant-move selection, ablation/surface-tax judgment, reification, review comment law, negative capability, route receipts, or proof-bearing refusal to mutate.
60SKILL.mdUpdated Jun 9, 2026
tkersey/algebra-driven-design
development
VerifiedTrustedCommunity
Apply Algebra-Driven Design. Use for ADD, denotational design, combinator models, law-driven architecture, domain algebra, property tests, codebase modeling, event sourcing, workflow design, or agentic skill design. If the canonical bundle is unavailable, use this wrapper as the minimal ADD kernel and report the missing bundle path.
60SKILL.mdUpdated May 10, 2026