jbro/writing-clearly-and-concisely
skills/writing-clearly-and-concisely/SKILL.md
Use when writing or editing human-facing prose that needs clearer, more concise wording.
testing
Updated Apr 6, 2026
$ install --global
skillsauthnpx skillsauth add jbro/pi-agent writing-clearly-and-conciselyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 2:37 AM27.8s7 files scanned
SKILL.md
- name:
- writing-clearly-and-concisely
- description:
- Use when writing or editing human-facing prose that needs clearer, more concise wording.
Writing Clearly and Concisely
Use this skill for docs, READMEs, PR text, commit messages, UI copy, errors, comments, and explanations.
Load Policy (Token-Critical)
- NEVER load
elements-of-style.md(archival source only; very large). - Start with
Readquick-checklist.min.mdin this skill's directory. - If you need deeper guidance on sentence structure and style principles, read
rules-core.min.md. - If you need usage/word-choice fixes, read
misused-words.min.md. index.mdis a compact router for which file to load.
Workflow
- Draft or inspect text.
- Apply
quick-checklist.min.md. - Load one deeper min file only if needed.
- Return concise revision + brief rationale.
Default to the smallest useful context.
Related Skills
jbro/writing-plans
development
VerifiedTrustedCommunity
Use when you have a spec or requirements for a multi-step task, before touching code
SKILL.mdUpdated Apr 6, 2026
jbro/verification-before-completion
data-ai
VerifiedTrustedCommunity
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
SKILL.mdUpdated Apr 6, 2026
jbro/using-superpowers
tools
VerifiedTrustedCommunity
Use when starting any conversation or task, to determine which skills apply before responding or taking any action.
SKILL.mdUpdated Apr 6, 2026
jbro/using-git-worktrees
tools
VerifiedTrustedCommunity
Use when starting feature work that needs isolation from the current workspace, or before executing an implementation plan.
SKILL.mdUpdated Apr 6, 2026