Agent Skillschrisbanes/skills › grounded-writing

grounded-writing

GitHub

用于起草或修订需发布/发送的文本,包括评论、回复及技术文章。遵循证据导向原则,确保内容真实、无虚构,并根据风格指南调整语气和结构。

skills/grounded-writing/SKILL.md chrisbanes/skills

Trigger Scenarios

起草需发布的文本 修订评论或回复 撰写技术散文

Install

npx skills add chrisbanes/skills --skill grounded-writing -g -y
More Options

Use without installing

npx skills use chrisbanes/skills@grounded-writing

指定 Agent (Claude Code)

npx skills add chrisbanes/skills --skill grounded-writing -a claude-code -g -y

安装 repo 全部 skill

npx skills add chrisbanes/skills --all -g -y

预览 repo 内 skill

npx skills add chrisbanes/skills --list

SKILL.md

Frontmatter
{
    "name": "grounded-writing",
    "description": "Use when drafting or revising text for the user to publish or send, including short review comments, replies, and evidence-led technical prose."
}

Grounded Writing

Core principle

Make the reasoning visible at the scale the artifact supports. Build clear, evidence-led writing in a conversational tone, then remove anything invented, generic, or included only to imitate a personality.

Procedure

  1. Confirm that the text is for the user to publish or send. Apply this style at any length, including one-sentence review comments and replies. Do not apply it to an ordinary assistant reply, quoted source text, or prose attributed to someone else.
  2. Read the style profile before drafting or revising.
  3. Establish the audience, purpose, requested format, supplied facts, and the user's actual position. Preserve the requested artifact shape rather than turning every deliverable into a blog post.
  4. Resolve missing material before writing:
    • Look up discoverable public facts when the task calls for research.
    • If a missing personal opinion or experience would materially change the text, ask the user and stop drafting that part.
    • If the gap is minor, use a conspicuous placeholder or state the uncertainty honestly. Never invent a first-person claim, result, preference, or memory.
  5. Choose the register from the style profile. Match the length and formality to the destination; short working comments should remain short.
  6. Shape the reasoning before polishing sentences. Prefer a concrete problem or observation, explain the mechanism, support it with evidence or an example, acknowledge the important limit, state the practical consequence, and end on the clearest remaining point. Omit any stage the artifact does not need. For a short comment, this may be only the actionable point and one supporting fact.
  7. Use the user's default language and regional conventions unless the request specifies otherwise. Keep paragraphs focused, mix sentence lengths, use first person only when grounded, and make headings earn their place.
  8. Edit once for style and once for truth. Remove generic scene-setting, marketing language, repeated conclusions, decorative catchphrases, and unsupported certainty.

Finish gate

Finish only when all of these are true:

  • The result still satisfies the requested format and purpose.
  • Every personal claim and substantive fact is supplied, verified, qualified, or clearly marked as missing.
  • The argument is concrete enough to follow without promotional filler.
  • Any caveat included changes the reader's understanding rather than acting as a disclaimer.
  • Spelling and grammar follow the user's default language and regional conventions.
  • The ending lands once and does not recap the whole piece.
  • The prose sounds natural when read aloud, without an accumulation of borrowed phrases, rhetorical questions, asides, or emoji.

If a check fails, revise the draft. If the failure depends on an unknown personal position, ask the user rather than smoothing over the gap.

Version History

  • 2026.8.24 Current 2026-08-27 17:15

Same Skill Collection

skills/compose-animations/SKILL.md
skills/compose-component-design/SKILL.md
skills/compose-focus-navigation/SKILL.md
skills/compose-modifier-and-layout-style/SKILL.md
skills/compose-performance/SKILL.md
skills/compose-recomposition-performance/SKILL.md
skills/compose-side-effects/SKILL.md
skills/compose-slot-api-pattern/SKILL.md
skills/compose-stability-diagnostics/SKILL.md
skills/compose-state-and-effects/SKILL.md
skills/compose-state-authoring/SKILL.md
skills/compose-state-deferred-reads/SKILL.md
skills/compose-state-hoisting/SKILL.md
skills/compose-state-holder-ui-split/SKILL.md
skills/compose-ui-testing-patterns/SKILL.md
skills/gradle-run/SKILL.md
skills/implement-issue/SKILL.md
skills/implement-with-subagents/SKILL.md
skills/kotlin-api-design/SKILL.md
skills/kotlin-concurrency-and-flow/SKILL.md
skills/kotlin-control-flow/SKILL.md
skills/kotlin-coroutines-structured-concurrency/SKILL.md
skills/kotlin-flow-state-event-modeling/SKILL.md
skills/kotlin-functions/SKILL.md
skills/kotlin-multiplatform-expect-actual/SKILL.md
skills/kotlin-types-value-class/SKILL.md
skills/run-github-project/SKILL.md
skills/shepherd/SKILL.md
skills/to-plan/SKILL.md
skills/using-chrisbanes-skills/SKILL.md

Metadata

Files
0
Version
2026.8.24
Hash
0495d2d6
Indexed
2026-08-27 17:15

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-28 00:27
浙ICP备14020137号-1 $Carte des visiteurs$