Add content-style writing skill and Kilo config#46467
Conversation
Introduce a new content-style skill under .claude/skills/content-style with a SKILL.md and three reference docs (content-types.md, positioning.md, style-rules.md) to capture Fleet's voice, format rules, and messaging guidance for authoring and reviewing public-facing content. Also add .kilo/kilo.jsonc to register the .claude/skills path so Kilo Code loads the skill automatically.
|
@mike-j-thomas this should introduce a new skill to Claude such that any time Claude (or Kilo) are used to generate public facing content (blog posts, guides, presentations, etc.) it will follow the rules you've already defined in our branding and style guidelines. Feel free to add/edit/tweak as needed. |
There was a problem hiding this comment.
Claude Code Review
This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.
Tip: disable this comment in your organization's Code Review settings.
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Run ID: ⛔ Files ignored due to path filters (4)
📒 Files selected for processing (1)
WalkthroughThis PR adds a 🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
Pull request overview
Introduces a new .claude/skills/content-style skill intended to standardize Fleet’s public-facing writing voice, formatting, and messaging guidance, and adds a Kilo Code project config to auto-load skills from .claude/skills.
Changes:
- Add
.kilo/kilo.jsoncto register.claude/skillsas a Kilo Code skills path. - Add a new
content-styleClaude skill with core voice guidance and a “fast checklist”. - Add reference docs for content types, full style rules, and positioning/messaging guidance.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| .kilo/kilo.jsonc | Configures Kilo Code to load skills from .claude/skills. |
| .claude/skills/content-style/SKILL.md | Defines when/how to apply Fleet content voice + a high-frequency checklist. |
| .claude/skills/content-style/references/style-rules.md | Provides an expanded, example-driven style rules reference. |
| .claude/skills/content-style/references/positioning.md | Adds a positioning/messaging brief for marketing and sales content. |
| .claude/skills/content-style/references/content-types.md | Documents format discipline by content type and an article metadata template. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## Article endmatter template | ||
|
|
||
| Articles, guides, and announcements end with this YAML block. Match `articleTitle` to the H1 exactly. Don't fabricate the author, username, or date — ask if you don't have them. | ||
|
|
| # Fleet content style | ||
|
|
||
| Produce and refine written content that sounds like Fleet: radically honest, technically precise, and "Mister Rogers" kind. The reader is an IT professional, client platform engineer, or security practitioner. Write to them as a helpful expert peer, never as a salesperson. | ||
|
|
||
| This skill works both inside the Fleet repo and outside it. The rules below are self-contained, but when the handbook is present it is the source of truth — read it first so you always reflect the latest guidance. | ||
|
|
| - **Sentence case everywhere** — headings, subheadings, buttons, UI labels. "Host details," not "Host Details." Only proper nouns, acronyms, and self-styled names (macOS, osquery) keep their casing. | ||
| - **Commas, not em dashes.** Avoid em dashes entirely. Use a comma, a colon, or a new sentence. This is the single most common AI tell to strip. | ||
| - **Oxford comma, always.** "macOS, Windows, and Linux." |
Introduce a new content-style skill under .claude/skills/content-style with a SKILL.md and three reference docs (content-types.md, positioning.md, style-rules.md) to capture Fleet's voice, format rules, and messaging guidance for authoring and reviewing public-facing content. Also add .kilo/kilo.jsonc to register the .claude/skills path so Kilo Code loads the skill automatically.
Summary by CodeRabbit