Skip to content

kings general

Gui Reis edited this page Oct 28, 2026 · 3 revisions

kings-general

General-purpose utilities — small tools that belong to no project and no workflow. They carry no project paths and read no named path; the heavy lifting is a KingsScript command or a script shipped with the skill, and the plugin adds the judgment around it.

Source: plugins/kings-general.

Index

Components

Component Type What it does
site-icon Skill Saves the icon a site shows in the browser tab as a transparent PNG: resolves site, folder and size, runs several sites in parallel
site-icon-fetcher Agent Haiku. Runs kings site-icon, looks at the PNG and, when it's blank, a plain shape, tiny or a platform default, tries the site's other icon candidates
remote-session Skill Opens a Claude Code session that keeps running in tmux with Remote Control on, new or resumed: resolves name, folder and session id, runs kings ai-session, reports how to attach
notion-manage Skill How to write to Notion so it renders: the connector's Markdown syntax that works, the API through the ntn CLI (properties, status, select options, file uploads, trash), and check_markup.py, which reads a page back and flags blocks saved as literal text. Loaded before any Notion write, by any workflow

Flow

Note

"Get this site's tab icon as PNG."

flowchart TD
    A[Site URL] --> B[site-icon skill: site, folder, size]
    B --> C[site-icon-fetcher agent]
    C --> D[kings site-icon: SVG first, then PNG by size, ICO, /favicon.ico]
    D --> E{Agent looks at the PNG}
    E -->|good| F[Path, size and source]
    E -->|blank, plain, tiny| G[kings site-icon --list / --source: other candidates]
    G --> F
Loading

A remote session ("open another session called X") needs no agent: the skill resolves the name, the folder and whether to --resume, and kings ai-session starts it, refusing a name that's already running.

Notion writes need no agent either: notion-manage is the mechanics every Notion-writing workflow loads (the career pipeline's agents among them), and a write counts as done only after check_markup.py comes back clean.

The order of candidates follows what a browser tab shows. A raster icon is never upscaled: when a site publishes only 48 px, the PNG is 48 px and the report says so. An SVG is rendered by a browser engine (Chrome or rsvg-convert), since ImageMagick's own renderer drops gradients.

Requirements

Tool Why
KingsScript (kings) The site-icon and ai-session commands
tmux Keeps a remote session alive (remote-session)
Notion CLI (ntn), authenticated API writes and the markup checker (notion-manage)
ImageMagick Raster conversion, ICO frames
Chrome or rsvg-convert SVG rendering

Clone this wiki locally