Portka Tools

My own engineering contributions to the exciting and brand new field of cognitive instructions describing how to do a thing.

A Claude Code plugin marketplace · GitHub · Changelog · MIT

A small marketplace of Claude Code plugins. Add it once — the plugins then work in your local CLI and in ephemeral web sessions. No plugin code is copied into your repo, only a marketplace reference.

Plugins

`video-bug-analyzer`

Give Claude a screen recording and roughly when something happens; it extracts frames (contact sheet, scene cuts, per-timestamp zoom, before/after strips, ROI time-stack) and reasons over them. Plus quantitative modes: stutter & freeze-gap timing, frame-pacing jitter, motion and swirl-vs-suck flow, subject extent, black-screen detection, ROI OCR, feature measurement, and palettes. Needs ffmpeg.

Details →

`app-website-evaluator`

Audit an app or website and get a prioritized, evidence-backed report with a standardized scorecard — each dimension 0–100 + a letter grade, a coverage-honest overall, and optional --json. Covers SEO & crawlability, AI-readiness (llms.txt + JSON-LD validation), social/sharing, security, performance, and growth — tailored to the site's type and community.

Details →

`repo-bootstrap`

Onboard a repo to this marketplace: writes or merges .claude/settings.json (and optional CI) so a web session loads the plugins on start. Idempotent and non-clobbering. With --portka-standard, also installs a workflow CLAUDE.md, a git/gh permissions allowlist, and an enforced SemVer VERSION/CHANGELOG/README sync with a basic test suite.

Details →

`tab-chord-formatter`

Turn a messy guitar tab / chord sheet into a clean, readable layout for screen — or render a consistent monospace PDF songbook (one or many songs, a target songs-per-page). Standardized [Section] labels, chords aligned over the right lyrics, a tidy metadata header, and well-formed 6-line ASCII tab. Needs python3 (plus headless Chromium for PDF).

Details →

Add it

In Claude Code, add the marketplace once, then install a plugin:

# add this marketplace (persists in ~/.claude)
/plugin marketplace add cportka/claude-plugins

# install a plugin
/plugin install video-bug-analyzer@portka-tools
/plugin install app-website-evaluator@portka-tools
/plugin install tab-chord-formatter@portka-tools
/plugin install repo-bootstrap@portka-tools

For a specific repo or a fresh web session, commit a .claude/settings.json that references the marketplace (or let repo-bootstrap write it). See the README and INTEGRATE.md.

Use it

Hand Claude a recording, or run the extractor directly:

S=plugins/video-bug-analyzer/skills/video-bug-analysis/scripts/extract-frames.sh
"$S" --video bug.mov --fps 2 --contact            # overview contact sheet
"$S" --video bug.mov --timestamps 0:12,0:34 --fps 8 # zoom + before/after
"$S" --video clip.mov --palette --colors 8        # dominant colours

Feedback

Hit a problem or have an idea? Open a Plugin feedback issue — each one is triaged into a fix and a new release.