Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add MichaelYcJo/SpecSeal --skill writing-stylegit clone --depth 1 https://github.com/MichaelYcJo/SpecSealWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/michaelycjo/specseal/writing-style)<a href="https://agentmods.dev/skills/michaelycjo/specseal/writing-style"><img src="https://agentmods.dev/badge/skills/michaelycjo/specseal/writing-style/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/michaelycjo/specseal/writing-style"><img src="https://agentmods.dev/badge/skills/michaelycjo/specseal/writing-style.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00120 | $0.05138 |
| Opus 5 | $0.00060 | $0.02569 |
| Sonnet 5 | $0.00024 | $0.01028 |
| Haiku 4.5 | $0.00012 | $0.00514 |
Grade A, and why
writing-style scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 301 lines — stays where its author put it; the contents beside it link to each section on GitHub.
writing-style — 리뷰·PR·리포트·대화
리뷰 코멘트·PR 본문·조사 리포트·사용자와의 대화를 쓰는 문체와 구성 규칙이다.
적용 방법: 「먼저」·「구성 규칙」·각 문서 유형 절은 언어 무관 — 어느 언어로 쓰든 적용한다. 문장 단위 규칙은 출력 언어의 절을 따른다 — 한국어면 「문장 규칙」, 영어면 맨 아래 「English prose rules」. 두 절은 번역본이 아니라 각 언어의 독립 규범이다.
먼저 — 무엇을 쓰는 글인가
대상에 따라 파일명 규칙이 정반대다. 이것을 먼저 정하지 않으면 반대로 쓴다.
| 글 | 파일명·행번호 | 이유 |
|---|---|---|
| 리뷰 코멘트 | 반드시 병기 | 읽는 사람이 그 자리를 열어야 한다 |
| 조사·분석 리포트 | 반드시 병기 | 주장의 근거이고, 검증할 수 있어야 한다 |
| PR 본문 | 쓰지 않는다 | 변경 목록은 diff 가 이미 보여준다. 여기서 할 일은 무엇이 달라지는가다 |
| 다른 팀에 답하는 코멘트 | 쓰지 않는다 | 상대는 내 코드를 열지 않는다. 좌표 대신 어떤 조건에서 그렇게 되는지를 적는다 |
| 커밋 메시지 본문 | 쓰지 않는다 | PR 본문과 같다 — squash 되면 그대로 커밋 본문이 된다 |
| 사용자와의 대화 | 사용자가 열어 볼 자리일 때만 | 터미널에서 오가는 답변이다. 대부분은 열어 볼 일이 없고, 좌표를 적으면 읽는 속도만 늦춘다 |
PR 본문의 기준은 이것이다 — 파일을 하나도 열지 않고 읽어도 무엇이 어떻게 바뀌는지 알 수 있는가.
대화는 이 표에서 가장 자주 쓰는 글이고, 문체가 가장 다르다. 다른 넷의
문체를 대화로 가져오면 읽히지 않는다 — outside-the-review.md 의
「사용자와의 대화에만 해당하는 것」이 그 절이다.
문장 규칙
완전한 문장으로 쓴다
압축체·명사 나열·전보문을 쓰지 않는다. 무엇이 문제고, 왜 문제고, 어떻게 고치는지가 문장으로 드러나야 한다.
나쁨 설정값 해석 실패 시 500 발생. 반경 과다.
좋음 설정값을 지역 id 로 해석하지 못하면 500 이 납니다. 그런데 그 설정값과 아무 관계 없는
다른 지역 사용자의 요청까지 함께 실패하므로, 영향 범위가 실제 원인보다 훨씬 넓습니다.
완전한 문장이지 긴 문장이 아니다
위 규칙은 전보문을 막으려는 것이지 길게 쓰라는 뜻이 아니다. 둘을 헷갈리면 문장은 완전한데 아무도 안 읽는 글이 된다.
나쁨 왜 경로를 옮기지 않았나 — 그 경로는 두 가지를 함께 따릅니다. 기존 클라이언트가
POST /orders/{id}/refund 를 호출하고 있고(하위 호환 유지가 전제), 부모 리소스
아래 하위 리소스를 두는 것이 이 저장소의 URL 규약입니다. 경로를 밖으로 빼면
호환이 깨져 공지가 필요한 사안이 됩니다. 테스트 한 줄을 지키려고 클라이언트
계약을 바꾸는 셈이고, 저는 이쪽이 더 비싸다고 봅니다.
좋음 경로를 옮기는 대신 테스트가 보는 범위를 /refund 아래로 좁혔습니다. 이 경로는
기존 클라이언트가 쓰는 그대로이고 URL 규약에도 맞아서, 테스트에 맞추려고
경로를 바꾸는 것은 순서가 뒤바뀐다고 봤습니다.
세 가지가 달라졌다.
- 한 문단에 한 가지만 담는다. 나쁜 쪽은 무엇을 했는지·왜 그랬는지·안 하면 뭐가 드는지를 한 문단에 밀어 넣었다.
- 줄표로 절을 잇지 않는다.
—가 한 문단에 두 번 넘게 나오면 문장이 끊기지 않는다는 신호다. 마침표로 끊는다. - 판단 근거는 한 문장이면 된다. "저는 이쪽이 더 비싸다고 봅니다" 처럼 자기 변론을 덧붙이면 길이만 늘고 설득력은 줄어든다.
잃은 것은 라벨을 붙여 세운다
무엇을 얻고 무엇을 잃었는지는 산문으로 풀지 말고 짧은 항목으로 갈라 적는다. 산문에 섞으면 읽는 사람이 "그래서 뭐가 없어진 거지"를 스스로 조립해야 한다.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · -83 lines 3e3f629a55dd
- 6d ago Changed · +80 lines · +39 tokens per session 655def5524af
- 10d ago First seen · 304 lines · 81 tokens per session scan A f922deb784a7
writing-style is a skill published in the GitHub repository MichaelYcJo/SpecSeal (1 stars, last pushed today), licensed MIT. It adds 120 tokens to every session and 5,138 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
local-ai-agents
Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…
next-cache-components-adoption
Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…
insight-error-page
Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…
next-cache-components-optimizer
Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…
next-partial-prefetching-adoption
Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the partialPrefetching flag, opt routes in with export const prefetch = 'partial', audit Link prefetch={true} behavior, preserve existing prefetched UI with…