Skip to content

Add content-style writing skill and Kilo config#46467

Open
allenhouchins wants to merge 1 commit into
mainfrom
allenhouchins-new-skill
Open

Add content-style writing skill and Kilo config#46467
allenhouchins wants to merge 1 commit into
mainfrom
allenhouchins-new-skill

Conversation

@allenhouchins
Copy link
Copy Markdown
Member

@allenhouchins allenhouchins commented May 29, 2026

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

  • Chores
    • Updated project configuration to support automated skill management infrastructure.

Review Change Stack

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.
@allenhouchins
Copy link
Copy Markdown
Member Author

@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.

@allenhouchins allenhouchins marked this pull request as ready for review May 29, 2026 17:39
Copilot AI review requested due to automatic review settings May 29, 2026 17:39
Copy link
Copy Markdown

@claude claude Bot left a comment

Choose a reason for hiding this comment

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

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.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 29, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 50069d2d-87f6-4e7c-8328-72c66c126055

📥 Commits

Reviewing files that changed from the base of the PR and between 8df30f9 and 9880234.

⛔ Files ignored due to path filters (4)
  • .claude/skills/content-style/SKILL.md is excluded by !**/*.md
  • .claude/skills/content-style/references/content-types.md is excluded by !**/*.md
  • .claude/skills/content-style/references/positioning.md is excluded by !**/*.md
  • .claude/skills/content-style/references/style-rules.md is excluded by !**/*.md
📒 Files selected for processing (1)
  • .kilo/kilo.jsonc

Walkthrough

This PR adds a .kilo/kilo.jsonc project configuration file to the repository. The file initializes Kilo Code with a skills discovery path set to .claude/skills, enabling automatic loading of skill subfolders based on their SKILL.md definitions. The configuration is minimal and includes documentation comments explaining the purpose of the skills path registration.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description provides clear context about the new skill and configuration file, but does not follow the repository's required PR template. Use the repository's PR template with sections for related issues, checklists, testing, and other required information.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the main changes: adding a content-style writing skill and Kilo configuration file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch allenhouchins-new-skill

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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.jsonc to register .claude/skills as a Kilo Code skills path.
  • Add a new content-style Claude 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.

Comment on lines +48 to +51
## 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.

Comment on lines +8 to +13
# 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.

Comment on lines +40 to +42
- **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."
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