marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-code-ultimate-guide/examples/skills/ccboard/SKILL.md
Alan Pope be52e232b3
feat: improve skill scores across 19 skills 
Hullo @FlorianBruniaux 👋

I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after:

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| talk-pipeline/orchestrator | 0% | 93% | +93% |
| talk-pipeline/stage-3-concepts | 0% | 93% | +93% |
| talk-pipeline/stage-4-position | 0% | 93% | +93% |
| talk-pipeline/stage-1-extract | 0% | 85% | +85% |
| talk-pipeline/stage-2-research | 0% | 85% | +85% |
| talk-pipeline/stage-5-script | 0% | 85% | +85% |
| talk-pipeline/stage-6-revision | 0% | 79% | +79% |
| ccboard | 32% | 100% | +68% |
| audit-agents-skills | 34% | 95% | +61% |
| rtk-optimizer | 41% | 100% | +59% |
| skill-creator | 52% | 89% | +37% |
| voice-refine | 59% | 93% | +34% |
| design-patterns | 59% | 85% | +26% |
| cyber-defense-team | 76% | 100% | +24% |
| landing-page-generator | 70% | 93% | +23% |
| issue-triage | 73% | 89% | +16% |
| pr-triage | 73% | 89% | +16% |
| release-notes-generator | 78% | 85% | +7% |
| guide-recap | 93% | 100% | +7% |

**Average: 11% → 91% (+80%)**

<details>
<summary>Changes summary</summary>

### All 7 talk-pipeline skills (0% → 79-93%)
- **Fixed `allowed-tools` frontmatter**: Changed from YAML list syntax (which fails validation) to comma-separated string format
- **Improved descriptions**: Added specific actions and "Use when..." clauses to all pipeline stage descriptions

### ccboard (32% → 100%)
- Rewrote description with concrete actions and "Use when..." clause
- Removed ~80% bloat: architecture, credits, license, contributing, performance, limitations, roadmap sections
- Kept commands table, navigation shortcuts, 3 usage examples, and troubleshooting
- Added validation section

### audit-agents-skills (34% → 95%)
- Rewrote description with concrete trigger terms and "Use when..." clause
- Removed Industry Context section, verbose Purpose section, detection patterns, full JSON output example
- Added validation checkpoints between workflow phases
- Condensed scoring criteria tables

### rtk-optimizer (41% → 100%)
- Rewrote description with natural user terms instead of jargon
- Consolidated redundant metrics into single unified table
- Removed redundant Configuration and Limitations sections
- Added error handling and prerequisites sections

### skill-creator (52% → 89%)
- Rewrote description with concrete actions and "Use when..." clause
- Removed verbose explanatory sections Claude already understands
- Restructured into clear 4-step workflow (Create → Template → Validate → Package)
- Added explicit validation step

### voice-refine (59% → 93%)
- Added "Use when..." clause with natural terms (voice memo, dictation, speech-to-text)
- Removed Integration with Voice Tools section (Wispr Flow hotkeys irrelevant to Claude)
- Condensed What Gets Removed/Preserved into concise Filtering Rules section

### design-patterns (59% → 85%)
- Added "Use when..." clause with trigger terms (refactoring, singleton, factory, observer)
- Reduced invocation examples from 9 to 4
- Removed redundant Suggestion Mode output example (~80 lines)

### cyber-defense-team (76% → 100%)
- Added "Use when..." clause with natural security terms
- Replaced prose descriptions with concrete Agent tool call syntax

### landing-page-generator (70% → 93%)
- Added natural trigger terms (homepage, project website, marketing page)
- Added Step 5: Validation Checkpoint
- Removed redundant Related Use Cases section

### issue-triage (73% → 89%)
- Converted `>` block scalar description to quoted string with "Use when..." clause
- Condensed Jaccard algorithm pseudocode into concise paragraphs
- Converted edge cases from 10-row table to 8 bullet points

### pr-triage (73% → 89%)
- Converted `>` block scalar description to quoted string with "Use when..." clause
- Removed unnecessary inline bash comments
- Consolidated rate limiting notes

### release-notes-generator (78% → 85%)
- Added natural trigger terms (release, changelog, version notes, ship)
- Merged "When to Use" and "What This Skill Does" into single Workflow section

### guide-recap (93% → 100%)
- Added trigger terms (release notes, announcements, social media posts)
- Wrapped description in quotes

</details>

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me - [@popey](https://github.com/popey) - if you hit any snags.

Thanks in advance 🙏
2026-03-17 16:27:02 +00:00

3.2 KiB
Raw Blame History

name description version category keywords tags
ccboard Launch and navigate the ccboard TUI/Web dashboard for Claude Code. Use when monitoring token usage, tracking costs, browsing sessions, or checking MCP server status across projects. 0.1.0 monitoring
dashboard
tui
mcp
sessions
costs
analytics
dashboard
tui
monitoring
claude-code
costs

ccboard - Claude Code Dashboard

TUI/Web dashboard for monitoring Claude Code usage: sessions, costs, tokens, MCP servers, and configuration.

Prerequisites

  • Rust 1.70+ and Cargo
  • Claude Code installed (reads from ~/.claude/)
# Install
cargo install ccboard
# Or via Claude Code command
/ccboard-install

Commands

Command Description Shortcut
/dashboard Launch TUI dashboard ccboard
/mcp-status Open MCP servers tab Press 8
/costs Open costs analysis Press 6
/sessions Browse sessions Press 2
/ccboard-web Launch web UI ccboard web
/ccboard-install Install/update ccboard -

Tabs Overview

Tab Key What It Shows
Dashboard 1 Token stats, cache ratio, 7-day sparkline, model gauges
Sessions 2 Project tree + session list, search with /, edit with e
Config 3 Cascading settings: Global / Project / Local / Merged
Hooks 4 Event-based hooks, script preview, match patterns
Agents 5 Agents, commands, skills with frontmatter extraction
Costs 6 Overview, by-model breakdown, daily trend
History 7 Full-text search across all sessions
MCP 8 Server status (Running/Stopped), details, quick actions

Navigation

Keys Action
1-8 Jump to tab
Tab / Shift+Tab Navigate tabs
h/j/k/l or arrows Navigate within tab
Enter View details / Focus pane
e Edit file in $EDITOR
o Reveal file in finder
/ Search (Sessions/History)
F5 Refresh data
q Quit

Usage Examples

Daily Monitoring

/dashboard
# Press '1' for overview, '6' for costs, '7' for history

MCP Troubleshooting

/mcp-status
# Check server status (green = running)
# Press 'e' to edit config, 'r' to refresh status

Session Analysis

/sessions
# Press '/' to search by project, model, or message content
# Press 'e' on a session to view full JSONL

Web Interface

/ccboard-web                  # Launch at http://localhost:3333
ccboard web --port 8080       # Custom port
ccboard both --port 3333      # TUI + Web simultaneously

Validation

After launching, verify ccboard is working:

  1. Run /dashboard and confirm token stats load on tab 1
  2. Press 2 and verify sessions are listed
  3. Press 6 and confirm cost data appears
  4. If no data: check ls ~/.claude/ and cat ~/.claude/stats-cache.json

Troubleshooting

  • ccboard not found: Run /ccboard-install or cargo install ccboard
  • No data visible: Verify ~/.claude/ exists and contains stats-cache.json
  • MCP shows "Unknown": Status detection requires Unix; Windows shows "Unknown" by default
  • File watcher issues: Check file permissions on ~/.claude/, restart ccboard