comms-community
Skill40 starsChanged 4 days agoApache-2.0View on GitHub
Use when drafting short community-facing replies for Discord, WhatsApp, or public chat about hushh-research, Kai, PKM, consent architecture, mobile/native tradeoffs, privacy boundaries, roadmap questions, or repo-based technical Q&A, including per-channel message formatting and length budgets.
In this repository69 other files it gives its agents.
- AGENTS.mdAGENTS.md
- hushh-webapp/AGENTS.mdAGENTS.md
- impeccableSkill
- agent-orchestration-governanceSkill
- analytics-observability-governanceSkill
- animateSkill
- animation-vocabularySkill
- apple-designSkill
- autonomous-rca-governanceSkill
- backend-agents-operonsSkill
- backend-api-contractsSkill
- backend-runtime-governanceSkill
- backendSkill
- brandkitSkill
- client-env-paritySkill
- codex-skill-authoringSkill
- context-refreshSkill
- contributor-onboardingSkill
- docs-governanceSkill
- emil-design-engSkill
- find-animation-opportunitiesSkill
- founder-brief-curationSkill
- frontend-architectureSkill
- frontend-cache-coherenceSkill
- frontend-design-systemSkill
- frontend-native-surface-mapperSkill
- frontendSkill
- frontend-surface-placementSkill
- future-plannerSkill
- github-contribution-governanceSkill
- hushh-consent-mcpSkill
- hushh-icon-themeSkill
- iam-consent-governanceSkill
- imagegen-frontend-mobileSkill
- imagegen-frontend-webSkill
- improve-animationsSkill
- industrial-brutalist-uiSkill
- kai-test-account-resetSkill
- less-text-karma-jiSkill
- mcp-developer-surfaceSkill
- mobile-nativeSkill
- mobile-parity-auditSkill
- mobile-plugin-contractsSkill
- morphy-axSkill
- one-voice-governanceSkill
- oss-license-governanceSkill
- pdf-artifact-generationSkill
- pick-ui-librarySkill
- pkm-upgrade-rehearsalSkill
- planning-boardSkill
- pr-governance-reviewSkill
- profile-uiSkill
- prototypeSkill
- puppy-one-harnessSkill
- quality-contractsSkill
- release-ios-appstoreSkill
- repo-contextSkill
- repo-operationsSkill
- review-animationsSkill
- reviewer-app-testingSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
26 rules. About 0 are common, 16 are distinctive, and 10 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈16
Distinctive · estimate
This author's own choices. Worth a look.
10
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Avoid overlap with docs-governance and repo-context.
- Distinctive: line 53
Read only the minimum repo docs needed to answer that exact question.
- Distinctive: line 54
Start with the direct answer and separate shipped behavior from future direction.
- Distinctive: line 59
if the premise is not grounded, say that directly before suggesting any fix
- Distinctive: line 62
When the user asks for a Discord-formatted post, announcement, cinematic cadence, launch note, or channel message, use native Discord …
- Very specific: line 63
use #, ##, or ### headings only when the channel message benefits from a clear top-level scan point.
- Very specific: line 64
use -# subtext sparingly for one quiet context line, not as body copy
- Distinctive: line 66
use short line breaks for cadence
- Very specific: line 67
use > for one defining sentence or motto, and >>> only for a deliberate multi-line quote block
- Distinctive: line 68
use bullets for scan paths, workflow steps, and proof points.
- Distinctive: line 69
use inline code for repo paths, commands, lanes, branches, IDs, and exact file names
- Distinctive: line 70
use fenced code blocks only for commands or copy/paste snippets, not for normal prose
- Distinctive: line 71
use masked links when the URL is useful but visually noisy, and expose critical repo paths as inline code when teammates need to find local …
- Distinctive: line 72
avoid spoilers, mentions, and role pings unless the user explicitly asks for them
- Very specific: line 74
treat 2000 characters as the official hard message-content limit from Discord's developer docs
- Very specific: line 75
use 1900 characters as the default safe copy budget so labels, edits, and pasted formatting do not push the message over the hard limit
- Distinctive: line 76
before finalizing any Discord post, count the drafted message.
- Distinctive: line 77
do not rely on Nitro/client-specific longer-message behavior unless the user explicitly asks for that target
- Distinctive: line 79
prefer splitting at paragraph or section boundaries.
- Very specific: line 80
use .agents/skills/comms-community/scripts/discord_chunk.py for deterministic chunking when the message is long or close to the limit
- Very specific: line 89
When the user asks for WhatsApp formatting, a WhatsApp draft, or a mobile-chat paste, follow references/whatsapp-formatting.md.
- Distinctive: line 93
If the question asks for the current architecture doc, cite the maintained top-level doc first and only then mention narrower subsystem …
- Distinctive: line 94
Do not invent certainty from a vague teammate report.
- Very specific: line 98
If the work becomes docs-home governance, use docs-governance.
- Very specific: line 99
If the question cannot be answered cleanly without first mapping the repo or choosing the right owner family, start with repo-context.
- Distinctive: line 100
If the task stops being public communication and becomes product or operational work, route to the correct owner skill.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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.
Files
Hussh Comms Community Skill
Purpose and Trigger
- Primary scope:
comms-community-intake - Trigger on Discord or public-chat reply drafting where the answer must be grounded in current repo docs and shipped boundaries.
- Avoid overlap with
docs-governanceandrepo-context.
Coverage and Ownership
- Role:
owner - Owner family:
comms-community
Owned repo surfaces:
.agents/skills/comms-community
Non-owned surfaces:
docs-governancerepo-context
Do Use
- Drafting concise public replies about shipped architecture, trust boundaries, roadmap boundaries, or repo-backed technical answers.
- Distinguishing clearly between current behavior and future direction.
- Selecting only the smallest set of evidence-bearing docs needed for the answer.
- Drafting repo-backed internal Q&A replies where the question may reference files, test failures, or implementation concerns that need verification before answering.
- Drafting Discord-ready or WhatsApp-ready messages with platform-native formatting and compact scan bullets.
Do Not Use
- Internal docs restructuring or repo-governance work.
- Product implementation, debugging, or operational workflows.
- Broad repo-orientation requests that should begin with
repo-context.
Read First
.agents/skills/comms-community/references/reply-rules.md.agents/skills/comms-community/references/whatsapp-formatting.mdwhen drafting WhatsApp/mobile-chat copy.agents/skills/codex-skill-authoring/references/truth-first-operating-kernel.mddocs/architecture/identity/README.mdconsent-protocol/docs/reference/developer-api.md
Workflow
- Infer the real architectural question before drafting the reply.
- Read only the minimum repo docs needed to answer that exact question.
- Start with the direct answer and separate shipped behavior from future direction.
- For repo-backed Q&A, verify the premise first:
- confirm the referenced file, module, or test surface exists in the current tree
- confirm the reported concern is actually visible in the current repo state when feasible
- classify material claims with the truth-first labels before drafting
- if the premise is not grounded, say that directly before suggesting any fix
- For material founder-language, product-direction, One/Kai/Nav, PCHP/BYOA, PKM/World Model, or roadmap replies, use the Founder Wiki North-Star Probe as a local evidence lane while keeping public replies public-safe. Private wiki evidence must not be cited or exposed unless the user explicitly asks for a private/internal draft; repo/wiki disagreement is
current_state_vs_north_star_drift. - For drafted reply/Q&A requests, default to one sendable reply: short, direct, evidence-backed, and sufficient to move the discussion forward. Add a second version only when the user explicitly asks for an alternative tone, more detail, or sharper correction.
- When the user asks for a Discord-formatted post, announcement, cinematic cadence, launch note, or channel message, use native Discord formatting deliberately:
- use
#,##, or###headings only when the channel message benefits from a clear top-level scan point; include a space after the heading marker - use
-#subtext sparingly for one quiet context line, not as body copy - bold only the anchor phrase, decision, or headline; avoid bolding whole paragraphs
- use short line breaks for cadence
- use
>for one defining sentence or motto, and>>>only for a deliberate multi-line quote block - use bullets for scan paths, workflow steps, and proof points; avoid Markdown tables because they are noisy in Discord chat
- use inline code for repo paths, commands, lanes, branches, IDs, and exact file names
- use fenced code blocks only for commands or copy/paste snippets, not for normal prose
- use masked links when the URL is useful but visually noisy, and expose critical repo paths as inline code when teammates need to find local files
- avoid spoilers, mentions, and role pings unless the user explicitly asks for them
- use
- Discord message length guard:
- treat
2000characters as the official hard message-content limit from Discord's developer docs - use
1900characters as the default safe copy budget so labels, edits, and pasted formatting do not push the message over the hard limit - before finalizing any Discord post, count the drafted message; if it exceeds the safe budget, split it into copy-ready batches
- do not rely on Nitro/client-specific longer-message behavior unless the user explicitly asks for that target
- for long posts, output
Discord copy batch 1/N,2/N, etc. with each batch inside its own fenced block so the user can copy one Discord-safe message at a time - prefer splitting at paragraph or section boundaries; if one paragraph exceeds the limit, split at a word boundary
- use
.agents/skills/comms-community/scripts/discord_chunk.pyfor deterministic chunking when the message is long or close to the limit
- treat
- For Discord posts that explain a Codex skill, use this structure by default:
- headline: what was created or changed
- one-line thesis in a block quote
What it does: 3-5 bullets focused on outcomesHow the flow works: compact numbered or bulleted flow from command/report to review actionWhy it matters: trust, speed, duplication control, maintainer leverageWhere to look: local path, ignored/generated status, and the canonical skill/script surfaceHow to use it next: one concrete next command or workflow
- When the user asks for WhatsApp formatting, a WhatsApp draft, or a mobile-chat paste, follow
references/whatsapp-formatting.md. - Choose evidence format by audience:
- public/community and internal shareable Q&A: prefer canonical GitHub markdown doc links on
main, not repo-relative paths - internal repo-debug Q&A: file links or GitHub issue/PR links are allowed when they directly prove the point
- If the question asks for the current architecture doc, cite the maintained top-level doc first and only then mention narrower subsystem docs.
- Do not invent certainty from a vague teammate report. If the concern is branch-local or not present in the current tree, say so and ask for the exact path, log, or PR.
Handoff Rules
- If the work becomes docs-home governance, use
docs-governance. - If the question cannot be answered cleanly without first mapping the repo or choosing the right owner family, start with
repo-context. - If the task stops being public communication and becomes product or operational work, route to the correct owner skill.
Required Checks
./bin/hushh docs verify
python3 .agents/skills/comms-community/scripts/discord_chunk.py --self-testDoes 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
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.

