Troy / Guides
Claude Code plugin and skills
The Claude Code plugin manifest in the Troy repository and its two skills: troy for driving the browser, and apply-fill for filling forms.
On this page
The repository is laid out as a Claude Code plugin. The manifest is .claude-plugin/plugin.json and the skills are in skills/.
A skill is instructions an agent reads before it acts. The browser’s refusals are enforced in code; the skills add the rules code cannot enforce, such as not closing a tab the person is using or not drafting an answer from facts nobody approved.
The manifest
| Field | Value |
|---|---|
name |
troy-browser |
version |
0.2.0 |
license |
MIT |
The manifest describes the plugin as a browser an agent can drive, which attaches to a real signed-in Chromium over the Chrome DevTools Protocol (CDP) and verifies every action. Its first capability is filling long application forms one question at a time from an approved facts file. It fills and verifies; it never submits.
The plugin version (0.2.0) is tracked separately from the app version (0.1.5).
The troy skill
Path: skills/troy/SKILL.md.
Claude Code uses it when you ask to test something in the browser, open a page, click through a flow, check that a page renders, or look for console errors. It teaches the steps on Driving Troy from an agent:
- Start Troy with
--cdp-port, then readagent-endpoint.jsonto find the port. - Attach with Playwright’s
connectOverCDP, which returns the tabs the user has open. - Read text with
innerTextor role queries, nevertextContent. - Attach console, page error and failed request listeners before navigating.
- Detach with
browser.close(), which does not quit Troy.
Its rules: one Troy, the user’s; do not close the user’s tabs; do not navigate away from a tab the user is working in without asking; and if the bridge is off, ask rather than falling back to a fresh headless browser.
It also covers loading unpacked extensions and lists what Troy refuses, with the instruction to say so rather than work around a refusal.
The skill predates the read pipeline on main. It tells Claude Code to read pages with innerText and describes the agent panel as returning text, which matches v0.1.5.
The apply-fill skill
Path: skills/apply-fill/SKILL.md.
Claude Code uses it when you ask it to fill a long application form, such as a Y Combinator (YC) application, an accelerator or grant form, or a job application. It detects every question, drafts each answer from a facts file you approved, and writes one answer at a time with your approval between each. It fills. It never submits. You submit.
Preconditions
- An approved facts file at
profile/facts.mdin the plugin directory. If it is missing or unconfirmed, the skill builds it first: short, checkable bullets grouped by project, with anything uncertain markedUNVERIFIED, handed to you to correct. Nothing is drafted until you say it is right. - The automation browser running, started with
node scripts/launch.mjs --url <application url>. By default this is Helium on a dedicated profile at~/.apply-fill/helium, on CDP port 9222. If that profile is not signed in to the target site, detection refuses, and the skill asks you to sign in rather than widening the allowlist. - Dependencies installed with
npm installin the plugin directory.
The loop
node scripts/detect.mjs --target ycombinator
This returns every field with its question, selector, maxLength, currentValue and answered. For each unanswered field the skill drafts an answer from the facts file within maxLength, shows it with a character count, and offers accept, edit, skip or regenerate. On accept:
printf '%s' "$ANSWER" | node scripts/fill.mjs --target ycombinator --selector '<selector>'
fill.mjs reads the value back after blur and exits non-zero on a mismatch. The skill reports that plainly instead of moving on.
Fields that already have a value are left alone unless you name one.
Rules
- Never fill an answer you have not seen and accepted. No batch mode.
- Never click submit or navigate away from the application page.
- Never invent a fact. If a question needs something not in the facts file, ask and offer to add it.
- Never fill password fields.
- No em dashes or en dashes:
fill.mjsrejects them.
Using it with Troy instead of Helium
The scripts attach to whatever answers at APPLY_FILL_CDP, which defaults to http://127.0.0.1:9222. To work in Troy, start Troy with a port and point the scripts at it:
APPLY_FILL_CDP=http://127.0.0.1:9333 node scripts/detect.mjs --target ycombinator
The flags and targets are documented in Action scripts.
Installing the skills
The repository does not include a marketplace listing or an install command for the plugin. The skill files are plain Markdown and can be read directly in skills/troy and skills/apply-fill.