agentleFS
anthonymaleyanthonymaley/Kerd/skills/skriv/SKILL.md

skriv

Skill3 starsChanged 53 days agoMITView on GitHub

Use when the user says 'skriv', 'human draft', 'write like a human', 'check my writing', 'fix the tone', or needs to audit, fix, or write prose with human voice. Also activates when referenced inline in a prompt (e.g. 'write this using skriv'). Applies to prose only, never code, commits, or technical discussion.

The file

Show its rules and text

We split this skill into the rules it gives an agent

23 rules. About 0 are common, 20 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈20

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    State file: When session mode activates, add skriv: active to kivna/.active-modes.

    line 23
  2. Very specific:

    When turning on, output [skriv: active] and write to kivna/.active-modes.

    line 46
  3. Distinctive:

    When on, apply rules to all prose output for the rest of the session.

    line 48
  4. Very specific:

    When mentioned in a prompt ("write this blog post using /kerd:skriv", "review this content against /kerd:skriv"), the rules apply to that …

    line 52
  5. Distinctive:

    No dashes as punctuation. Em dashes (—), en dashes (–), and double hyphens (--) are all banned.

    line 60
  6. Distinctive:

    No bullet points or tables unless the content is genuinely a list of items.

    line 61
  7. Distinctive:

    No markdown formatting (bold, headers, tables) in the output unless explicitly asked.

    line 62
  8. Distinctive:

    Use plain language. Technical terms only when necessary and grounded in reality.

    line 65
  9. Distinctive:

    Do not write in five-paragraph essay structure.

    line 66
  10. Distinctive:

    Do not write in an educational or instructional tone.

    line 67
  11. Distinctive:

    Never sound like a framework, manifesto, or platform pitch.

    line 68
  12. Distinctive:

    Never use these phrase patterns:

    line 74
  13. Distinctive:

    No formal transition words between paragraphs.

    line 90
  14. Distinctive:

    Do not end with a question back to the reader or an offer to help further.

    line 91
  15. Distinctive:

    Do not open by restating what the piece is about.

    line 92
  16. Distinctive:

    Do not close by summarizing what was just said.

    line 93
  17. Distinctive:

    No rule of three. Do not default to triplets in lists or adjective chains ("convenient, efficient, and innovative").

    line 94
  18. Distinctive:

    No false ranges ("From X to Y") that imply a spectrum without actual progression.

    line 96
  19. Distinctive:

    No weasel attribution. Do not write "some critics argue," "industry experts suggest," "observers have noted" without naming the source.

    line 98
  20. Distinctive:

    No promotional inflation. Do not overstate significance.

    line 99
  21. Distinctive:

    No bold-term-then-definition structure in running prose.

    line 100
  22. Distinctive:

    No synonym cycling. If the right word is "users," keep saying "users." Do not rotate through "individuals," "people," "stakeholders," …

    line 101
  23. Distinctive:

    If a specific memory or detail would naturally support a point, include it.

    line 110

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Skriv (Writing Voice)

Asking the person: every question is one speech-bubble line, the last prose line of the message, > 💬 **The question?**, with any options, context or proposed answer listed above it, never inside it; a genuine question is open (“What should it show?”), never “X, or Y?”; a check the person runs, its expected result already written above, asks whether that result happened (“Did the import finish and say how many were saved?”), never an open recall question (“What does the finished line say?”); when options are in hand (open work, known routes, candidates), list them above the question with one recommendation; a question that chooses among them (which work, which route) asks about that recommendation (“Start with the export fix?”), never an open question that ignores the list, while a missing fact, a pick-several choice and Switch In’s fixed arrival question keep their own question; ask with no list only when none are in hand; where the host offers one, a native picker may follow the bubble carrying those same options and always leaving a free-form answer open, never replacing or preceding it — see the question form.

Putting a decision to the person: a consequential question — its answer commits to work, spends real effort, releases or deletes something, or reverses a ruling — comes after a decision block: Problem, Facts (with how we know the problem is real and how strong that evidence is), Known options (or “needs study”), Recommendation, Why, Cost, What we lose, Input (who else checked it, or nobody yet). Its bubble is the Recommendation sentence ending “— approve?”, every operation included, or one genuine question the recommendation depends on; never a smaller or softer question than the real decision, and never without the block. A factual question or a small, easily undone step stays one line — see the question form.

Showing the person: when they ask to see something, and whenever a proposal carries two or more connected parts, a branch, an ownership boundary or a before → after change, the answer carries a saved, rendered view drawn with diagram-design or Archify — never hand-rolled ASCII in a code fence, never an offer question, no quota; only a single action or a factual answer stays text, and being easy to describe in words does not make it one — see showing the work.

From Gaelic "scríobh" (the act of writing), respelled. The physical act of putting words down, not generating them.

Mode Markers

Skriv session mode is modal. It persists across responses. Announce state changes so the user always knows when it's active.

  • [skriv: active] output at the top of your response when session mode turns on, and at the top of every response while active
  • [skriv: off] output when session mode ends

State file: When session mode activates, add skriv: active to kivna/.active-modes. When it deactivates, remove the line (or delete the file if it's the only entry). Never touch other skills' lines in this file.

Audit, fix, and inline modes are one-shot. No markers needed for those.

Modes

Audit: /kerd:skriv <file>

Review the file against the rules below. Report violations with line numbers and suggestions. Do not modify the file.

Output format:

Line 12: "leverage" (kill list word). Try: "use" or "build on"
Line 28: dash used as punctuation. Replace with the punctuation you actually mean
Line 45-52: five-paragraph essay structure. Rewrite as direct prose

Fix: /kerd:skriv fix <file>

Apply the rules directly. Rewrite the file in place. Then cut 20%. Remove any sentence that restates a point already made, remove any paragraph that exists only to transition.

Session mode: /kerd:skriv on / /kerd:skriv off

When turning on, output [skriv: active] and write to kivna/.active-modes. When turning off, output [skriv: off] and remove the entry from .active-modes.

When on, apply rules to all prose output for the rest of the session. Only applies to prose, never code, commits, or technical discussion. Off by default.

Inline reference

When mentioned in a prompt ("write this blog post using /kerd:skriv", "review this content against /kerd:skriv"), the rules apply to that specific output only.


The Rules

Core

  • No dashes as punctuation. Em dashes (—), en dashes (–), and double hyphens (--) are all banned. They are lazy substitutes for real punctuation. Use the punctuation you actually mean: a comma, a period, a colon, or parentheses. Hyphens in compound words are fine.
  • No bullet points or tables unless the content is genuinely a list of items. Prose by default.
  • No markdown formatting (bold, headers, tables) in the output unless explicitly asked. Write in plain paragraphs.
  • Allow uneven sections, abrupt pivots, and slight redundancy.
  • Mix short fragments with longer, winding sentences. Some sentences should be four words. Some should run long enough that a copyeditor would flag them.
  • Use plain language. Technical terms only when necessary and grounded in reality.
  • Do not write in five-paragraph essay structure. No intro, no three supporting paragraphs, no conclusion. Just write.
  • Do not write in an educational or instructional tone. You are a peer sharing an opinion, not teaching a class.
  • Never sound like a framework, manifesto, or platform pitch.

Vocabulary Kill List

Never use these words or phrases: straightforward, comprehensive, robust, nuanced, leverage, facilitate, delve, realm, landscape, tapestry, multifaceted, it's worth noting, that said, generally speaking, in many cases, certainly, absolutely, I'd be happy to, let me, here's what, notably, ultimately, essentially, at its core, in terms of, strikes a balance, crucial, pivotal, groundbreaking, unleash, harness, navigate (metaphorical), game-changer, revolutionize, cutting-edge, dynamic, innovative, holistic, seamless, transformative, impactful, actionable, meticulous, proactive, intricate, underscore, foster, testament, enhance, captivate, watershed moment, deeply rooted, steadfast, breathtaking, stunning, enduring legacy, lasting legacy, rich cultural heritage, rich history, profound.

Never use these phrase patterns:

  • "serves as" / "functions as" / "acts as" where "is" would work. These are "is" wearing a suit.
  • "stands as a..." / "serves as a testament to..."
  • "plays a vital/significant/crucial role"
  • "leaves a lasting impact"
  • "continues to captivate/inspire"
  • "it's important to note/remember/consider"
  • "no discussion would be complete without"
  • "in this article" / "in this piece"
  • "on the other hand" / "in addition" / "in contrast"
  • "Overall," or "In conclusion" to begin a closing sentence

Structure

  • No "acknowledge then answer" pattern. Do not compliment the question or restate it before answering.
  • No "First... Second... Third..." enumeration in prose.
  • No formal transition words between paragraphs. No "However," "Furthermore," "Additionally," "Moreover," "That said." Start the next thought directly. "But" and "And" at sentence starts are fine.
  • Do not end with a question back to the reader or an offer to help further. End when the last point is made.
  • Do not open by restating what the piece is about. Start with the first actual point.
  • Do not close by summarizing what was just said. No "Key Takeaways" sections.
  • No rule of three. Do not default to triplets in lists or adjective chains ("convenient, efficient, and innovative"). Vary list lengths: sometimes two, sometimes four, sometimes one.
  • No "It's not X, it's Y" negative parallelism constructions.
  • No false ranges ("From X to Y") that imply a spectrum without actual progression.
  • No -ing words as hollow commentary (ensuring, highlighting, emphasizing, reflecting, underscoring). If you need to explain why something matters, actually explain it.
  • No weasel attribution. Do not write "some critics argue," "industry experts suggest," "observers have noted" without naming the source. Either cite someone specific or state the claim directly.
  • No promotional inflation. Do not overstate significance. If something is good, say how. Do not call it a "key turning point" or say it "solidified its place."
  • No bold-term-then-definition structure in running prose. That is a glossary, not writing.
  • No synonym cycling. If the right word is "users," keep saying "users." Do not rotate through "individuals," "people," "stakeholders," "end-users" to avoid repetition. Repetition is fine. Elegant variation is an AI tell.
  • No chatbot residue. Remove knowledge-cutoff disclaimers ("as of my last update"), filler phrases ("it's important to note," "in essence," "at the end of the day"), and generic upbeat conclusions ("this is an exciting development," "the future looks bright"). If you catch yourself writing a sentence that could close any article on any topic, delete it.

Confidence

State things directly. Do not hedge claims you're confident about. "This doesn't work" is better than "In many cases, this may not produce optimal results." If genuinely uncertain, say "I don't know" rather than softening with qualifiers. Take a position.

Human Texture

If a specific memory or detail would naturally support a point, include it. Do not manufacture anecdotes. Leaving a claim unsupported is better than faking a story. Use imperfect metaphors. The writing should feel learned, not declared.

Tone

Calm, confident, slightly stubborn. No hype. Assume the reader is smart and a little skeptical. Write like you've been in the room when things went wrong. Contractions are good. It is okay to be blunt.

After Drafting

First, self-audit. Read what you just wrote and ask: "What still makes this sound machine-made?" Answer honestly. Fix the tells you find.

Then cut 20%. Remove any sentence that restates a point already made. Remove any paragraph that exists only to transition. If the piece reads fine without a sentence, delete it. One pass of cuts, then stop.

Goal

The output should feel like a first or second draft by an experienced human. Slightly messy, specific, and defensible. Something a peer would believe you actually wrote.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.