Give the agent skill a front door - #98
Merged
Merged
Conversation
The skill was the only distribution surface with nowhere to land. The web app never mentioned it -- not a page, not a nav link, not a word -- and the README reached it at section 5, past two hundred lines of badges for other people's registries. That is backwards, and the traffic says so. Of every channel this project ships to, the skill is the only one a person installs by choice; the rest are machine-readable indexes, and machines are what came: 450 unique cloners against 77 unique viewers in fourteen days, a ratio unchanged since July. So it gets what the desktop app and the Word add-in already have: - /skill, bilingual, leading with the one line that installs it, then the two modes, then the two things it refuses to do -- inventing a number and naming an author -- because that is what a reader is actually deciding about - a nav link, on every host, since it runs in the reader's editor not in ours - a place in the README's top links, ahead of the Windows download The rule counts on the page are read from the packs this build ships. Every number this project has typed about itself has gone stale at least once. Two defects the source did not show and a render did: the mode placeholders came out as <your draft> because the locale held entities Razor encoded again, and the two-mode list used markup the grid does not style. Both found by serving the page and looking at it. Also guarded, because it is the same defect as #77 in a different file: the locale tests checked that a translation was *current* and never that it was *complete*. A locale this project credits itself for now has to define every key; a community translation may stay partial, since demanding all 508 keys of a first pull request turns a partial translation into no translation. Verified by mutation: removing two Spanish keys fails, naming them. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015PEbbiYSNPw7jE3LrPNhyF
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The skill was the only distribution surface with nowhere to land. The web app never mentioned it — not a page, not a nav link, not a word — and the README reached it at section 5, past two hundred lines of badges for other people's registries.
That is backwards, and yesterday's traffic numbers say so. Of every channel this project ships to, the skill is the only one a person installs by choice. The rest are machine-readable indexes, and machines are what came: 450 unique cloners against 77 unique viewers in fourteen days, a ratio unchanged since July.
What it gets
The same treatment the desktop app and the Word add-in already have:
/skill, bilingual — the one line that installs it, then the two modes, then the two things it refuses to do: invent a number, or name an author. That refusal is what a reader is actually deciding about.The rule counts on the page (94 English, 78 Spanish) are read from the packs this build ships. Every number this project has typed about itself has gone stale at least once.
No new badge. The complaint was that other people's badges dominate the top of the README; a thirteenth would not have helped.
Two defects the source did not show
Found by serving the page and looking at it, not by reading the diff:
<your draft>— the locale held entities that Razor encoded again<strong>/<span>where the grid styles.dl-itemwith<h3>/<p>, so it rendered as "EditRewrites the draft…" with no separationThe guard
The locale tests checked that a translation was current and never that it was complete — the same shape as the defect #77 found in the evidence report, where three tests watched
report.es.jsonand none noticed it carried 39 of 76 blocks.A locale this project credits itself for must now define every key. A community translation may stay partial: demanding all 508 keys of a first pull request turns a partial translation into no translation.
Verified by mutation: removing two Spanish keys fails, naming them.
375 + 72 + 7, plus the desktop job's 31.
🤖 Generated with Claude Code
https://claude.ai/code/session_015PEbbiYSNPw7jE3LrPNhyF