Skip to content

feat(skills): add writing-style skill for prose rule application - #196

Merged
bbsngg merged 2 commits into
mainfrom
feat/writing-style-rules
Sep 3, 2026
Merged

feat(skills): add writing-style skill for prose rule application#196
bbsngg merged 2 commits into
mainfrom
feat/writing-style-rules

Conversation

@MarkZhang777

Copy link
Copy Markdown
Collaborator

Summary

Adds skills/writing-style/SKILL.md, a drop-in skill that applies the 21 prose rules from the agent-style project (yzhao062, CC BY 4.0). The rule set is 12 canonical rules from Strunk, Orwell, and Pinker, plus 9 field-observed AI-output patterns.

Users invoke it with /writing-style in chat, optionally with a draft to revise. The skill surfaces in the Paper Writing category of the ⚡ Skills picker alongside the complementary /inno-humanizer, which targets AI-specific tells rather than canonical prose rules. The existing skillExpander.js resolves the slash command, so no backend, UI, or database changes were needed.

Upstream: https://github.com/yzhao062/agent-style (pinned commit 6633397).

Test plan

  • Inside an active chat, the ⚡ Skills picker → Paper Writing category shows a writing-style chip alongside inno-humanizer, inno-paper-writing, etc.
  • The expanded block renders the CC-BY-4.0 attribution to yzhao062/agent-style.
  • npm run typecheck passes.

Drop-in skill that applies the 21 prose rules from "The Elements of
Agent Style" (yzhao062, CC BY 4.0) — 12 canonical rules (Strunk,
Orwell, Pinker) plus 9 field-observed AI-output patterns. Users
invoke via /writing-style, optionally with a draft to revise. Surfaces
in the Paper Writing category of the skill picker alongside the
complementary /inno-humanizer (which targets AI-specific tells).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
bbsngg
bbsngg previously approved these changes Sep 3, 2026

@bbsngg bbsngg left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Small, self-contained, CI green. SkillDropdown renders straight from SKILL_CATEGORIES and the resolve route locates SKILL.md by directory, so /writing-style works in chat as-is. License and pinned upstream commit are recorded in the frontmatter. Approving.

One optional follow-up: the skill isn't registered in skills/skills-catalog-v2.json / stage-skill-map.json (compare #168), so it won't show in the Skills Dashboard. Running scripts/export-skills-catalog-v2.mjs should pick it up; fine to do in a follow-up PR.

Add the skill to skills-catalog-v2.json (totalSkills 170 -> 171), the
taxonomy overrides, the Paper Writing stage map, the stage tag mapping,
and the skills/README.md tree, matching how sibling skills such as
inno-humanizer are registered, so it shows up in the Skills Dashboard
and pipeline stage suggestions, not only in the chat picker.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NBqmTvJRhyysMvMvL6cp7x
@bbsngg

bbsngg commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Pushed a follow-up commit on this branch registering writing-style in the catalog files (skills-catalog-v2.json, taxonomy overrides, stage-skill-map.json, skill-tag-mapping.json, and the skills/README.md tree), mirroring how inno-humanizer is registered, so the skill also appears in the Skills Dashboard and stage suggestions.

Heads-up unrelated to this PR: scripts/export-skills-catalog-v2.mjs currently fails on main because skills/autoresearch/SKILL.md has an unquoted description: containing : , which js-yaml rejects. I added the catalog entry by hand rather than regenerating (a full regen produces a ~9k-line diff against the committed catalog). Worth a separate one-line fix.

@bbsngg bbsngg left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-approving after the catalog registration commit (86b6600): CI green, all five JSON files parse.

@bbsngg
bbsngg merged commit b9e2f9f into main Sep 3, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants