Skip to content

docs: add repo-local Codex skills#230

Open
nathanhuh wants to merge 2 commits into
mainfrom
docs/229-repo-local-skills
Open

docs: add repo-local Codex skills#230
nathanhuh wants to merge 2 commits into
mainfrom
docs/229-repo-local-skills

Conversation

@nathanhuh

@nathanhuh nathanhuh commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add the unic-update-dependencies repo-local skill for conservative Go/toolchain dependency maintenance.
  • Add the unic-ux-review repo-local skill for running the real TUI, capturing screenshots, reviewing UX, and optionally implementing scoped polish.
  • Include a reusable isolated-config TUI capture helper for repeatable context/service picker screenshots.

Related Issues

Closes #229

Validation

  • make test
  • make build
  • Ruby YAML parse checks for both skill files and both agents/openai.yaml files
  • PYTHONPYCACHEPREFIX=/private/tmp/unic-skill-shipping-pycache python3 -m py_compile .agents/skills/unic-ux-review/scripts/capture_unic_tui.py
  • /Users/nathanhuh/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3 .agents/skills/unic-ux-review/scripts/capture_unic_tui.py --out-dir /private/tmp/unic-skill-q-fix-capture --skip-build

Checklist

  • Scope is focused
  • Branch name follows docs/branch-naming-harness.md
  • Documentation harness reviewed (docs/documentation-harness.md)
  • README updated if user-facing behavior changed
  • Relevant docs/ pages updated if architecture, auth, config, or workflow changed
  • Tests/validation included
  • Breaking changes documented

@coderabbitai

coderabbitai Bot commented Jun 18, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@nathanhuh, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 12 minutes and 50 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 31fc2698-d15e-4d70-bb99-6542eabdb0bc

📥 Commits

Reviewing files that changed from the base of the PR and between 0543b0c and 8507563.

📒 Files selected for processing (5)
  • .agents/skills/unic-update-dependencies/SKILL.md
  • .agents/skills/unic-update-dependencies/agents/openai.yaml
  • .agents/skills/unic-ux-review/SKILL.md
  • .agents/skills/unic-ux-review/agents/openai.yaml
  • .agents/skills/unic-ux-review/scripts/capture_unic_tui.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/229-repo-local-skills

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary

This PR adds two valuable repo-local Codex skills for dependency management and UX review. The documentation is comprehensive and the Python TUI capture script is well-structured. However, there are critical error handling defects in the Python script that must be fixed before merge.

Critical Issues (Must Fix)

The capture_unic_tui.py script has four crash-risk and logic error issues:

  1. Broad exception handling hides PIL import failures, making debugging impossible
  2. Silent timeout failures in wait_for_capture() return incomplete data instead of failing explicitly
  3. Unhandled subprocess failures cause crashes instead of proper error reporting
  4. Missing error handling for tmux session creation leads to subsequent failures

These issues will cause the script to fail silently or crash unexpectedly in production use, blocking the workflow described in the skill documentation.

Files Reviewed

  • .agents/skills/unic-update-dependencies/SKILL.md
  • .agents/skills/unic-update-dependencies/agents/openai.yaml
  • .agents/skills/unic-ux-review/SKILL.md
  • .agents/skills/unic-ux-review/agents/openai.yaml
  • .agents/skills/unic-ux-review/scripts/capture_unic_tui.py ⚠️ (needs fixes)

You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

Comment thread .agents/skills/unic-ux-review/scripts/capture_unic_tui.py Outdated
Comment thread .agents/skills/unic-ux-review/scripts/capture_unic_tui.py
Comment thread .agents/skills/unic-ux-review/scripts/capture_unic_tui.py Outdated
Comment thread .agents/skills/unic-ux-review/scripts/capture_unic_tui.py
@nathanhuh

Copy link
Copy Markdown
Contributor Author

/q review

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed all 5 files in this PR adding repo-local Codex skills for dependency management and UX review.

The changes add well-structured documentation and a comprehensive Python script for automated TUI screenshot capture. The code demonstrates good practices including proper error handling, resource cleanup via finally blocks, graceful degradation for optional dependencies, and appropriate use of test fixtures.

Note: One comment was flagged regarding exception handling, but upon further review, the finally block correctly executes even with return statements in exception handlers, ensuring proper cleanup in all code paths.


You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

Comment thread .agents/skills/unic-ux-review/scripts/capture_unic_tui.py
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add repo-local Codex skills for dependency updates and UX review

1 participant