# Harnessay

> Profile Claude Code transcripts. /harnessay = context budget report + skill candidates, /harnessay eval = skill regression tests. Triggers - "harnessay", "context report", "where did my tokens go", "skill candidates", "skill regression"

- Skill: `nks0614/harnessay` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add nks0614/harnessay`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nks0614/harnessay/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: nks0614 (https://skillmd.com/u/nks0614)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nks0614/harnessay

---


# harnessay

All scripts live in this skill's base directory (shown above as "Base directory
for this skill" — referred to as `$SKILL_DIR` below). Python 3.8+, stdlib only.

## Default (report)

1. Run:
   ```bash
   python3 "$SKILL_DIR/harnessay.py" -o <scratchpad>/report.html
   ```
   If the user asks about a specific period ("this month", "since the fix"),
   add `--since YYYY-MM-DD`.
2. Relay the stdout headline sentence to the user.
3. Send report.html to the user (if headless, just give the path).
4. Summarize the top 5 rows of the report's "Skill candidates" section with
   their personal/project suggestion. Never auto-create skills — the user
   decides what to promote.

## eval (skill regression tests)

If the arguments contain "eval":

```bash
python3 "$SKILL_DIR/evalrun.py"
```

- Pass through `--only <id-substring>` and a custom tasks.json path if given.
  Golden tasks live in `$SKILL_DIR/eval/tasks.json` by default; users can point
  to their own file.
- Report the pass rate and the first lines of output for any FAIL.
- Results accumulate in results.jsonl next to the tasks file; no extra saving
  needed.