Skip to content

Output Conventions

Terminal output patterns used across all GHS skills. Consistent formatting makes reports scannable and familiar.

Status Indicators

IndicatorMeaning
[PASS]Check passed / fix applied
[FAIL]Check failed / fix failed
[WARN]Cannot verify (permissions)
[INFO]Informational only
[NEEDS_HUMAN]Requires manual intervention
[FAILED]Agent/operation failed

Health Check Report Structure

## Repository Scan: {owner}/{repo}

### Health Checks

#### Tier 1 --- Required
  [PASS] README.md --- Found (2.3 KB)
  [FAIL] LICENSE --- Not found
  [WARN] Branch protection --- Unable to check (requires admin access)

#### Tier 2 --- Recommended
  [PASS] .gitignore --- Found
  [FAIL] .editorconfig --- Not found

### Health Score: 14/51 (27%)

  Tier 1:  8/16  ████░░░░ (50%)
  Tier 2:  6/26  ██░░░░░░ (23%)
  Tier 3:  0/9   ░░░░░░░░ (0%)

Progress Bar

Width:  8 characters
Filled: █  (U+2588)
Empty:  ░  (U+2591)

Filled count = round(percentage / 100 x 8).

Table Patterns

Dashboard Table (multi-repo)

| Repository | Health | Progress | Issues | Open | PRs | Last Scan |
|------------|--------|----------|--------|------|-----|-----------|
| owner/repo | 10/31 (32%) | ██░░░░░░ | 18 | 15 | 3 | 2026-02-26 |

Item List Table

| # | Item | Tier | Points | Status | Issue | PR |
|---|------|------|--------|--------|-------|----|
| 1 | README | 1 | 4 | FAIL | #42 | --- |

Results Table (post-fix)

| Item | Tier | Pts | Status | PR |
|------|------|-----|--------|----|
| LICENSE | T1 | 4 | [PASS] | #12 |
| Branch Protection | T1 | 4 | [PASS] | --- (API) |

Batch Plan Table

| # | Item | Tier | Pts | Category | Issue | Branch | Worktree |
|---|------|------|-----|----------|-------|--------|----------|
| 1 | LICENSE | T1 | 4 | B (file) | #42 | fix/license | repos/.../ |

Summary Blocks

Each skill ends with a Summary: block. Key metrics per skill:

SkillSummary Fields
backlog-fixApplied, PRs created, Points recovered, New health score
backlog-syncCreated, Updated, Reopened, Closed, Already synced, Skipped
issue-triageTriaged count, Types breakdown, Priority breakdown
merge-prsMerged, Failed, Skipped

Display Limits

ConstantValue
Max terminal issues20 (note "+N more" if exceeded)
Issue body truncation500 chars
Title kebab truncation50 chars

Routing Suggestions

Skills suggest next steps at the end of their output:

AfterSuggest
repo-scanbacklog-sync, backlog-fix, backlog-board
backlog-fixmerge-prs, backlog-board, repo-scan
backlog-syncbacklog-fix, backlog-board
issue-triageissue-analyze, issue-implement
issue-analyzeissue-implement
issue-implementmerge-prs
merge-prsrepo-scan, backlog-board

Released under the MIT License.