diff --git a/marketing/2026-07-20-claude-code-skills-distribution-kit.md b/marketing/2026-07-20-claude-code-skills-distribution-kit.md new file mode 100644 index 0000000..d403945 --- /dev/null +++ b/marketing/2026-07-20-claude-code-skills-distribution-kit.md @@ -0,0 +1,96 @@ +# claude-smart distribution kit — Claude Code skills + agent learning (2026-07-20) + +## Why this angle + +Developers searching around Claude Code skills, Claude Code memory, and Codex memory usually have the same pain: the assistant repeats a correction or re-discovers a workflow every session. `claude-smart` should show up as the lightweight local learning layer for that problem. + +Primary message: + +> claude-smart turns corrections and successful workflows into durable Preferences, Project-specific skills, and Shared skills that Claude Code, Codex, and OpenCode reuse in future sessions. + +This preserves the public terminology from `DEVELOPER.md` and avoids raw Reflexio storage/API names. + +## High-signal audiences + +1. **Claude Code plugin users** who already use slash commands/hooks and are trying to make Claude remember repo conventions. +2. **Codex users** who want local memory without introducing a hosted service or new API key. +3. **OpenCode users** evaluating plugins that help agents reuse project workflows. +4. **Agent-memory builders** comparing transcript memory with future-facing rules or skills. + +## Suggested first-party post for GitHub Discussions / community changelog + +Use only in first-party or clearly project-owned channels; do not drop into unrelated threads. + +```text +We’ve been tightening the positioning for claude-smart around “learning, not just memory.” + +The plugin runs locally for Claude Code, Codex, and OpenCode. It turns corrections and successful workflows into three durable artifacts: + +- Preferences: project-scoped facts about how you work +- Project-specific skills: repo-local rules with triggers/rationales +- Shared skills: durable patterns that can transfer across projects + +The practical outcome: future sessions start from the learned path instead of rediscovering the same test command, deploy caveat, dependency rule, or review preference. + +Repo: https://github.com/ReflexioAI/claude-smart +Benchmark notes: https://github.com/ReflexioAI/claude-smart/blob/main/EXPERIMENT.md +``` + +## Suggested X post for Yi to review + +No X action should be taken automatically. + +```text +Most “AI coding memory” captures what happened. + +The harder part is turning a correction into a rule the agent actually follows next time. + +claude-smart does that for Claude Code, Codex, and OpenCode with: +- Preferences +- Project-specific skills +- Shared skills + +Runs locally, powered by Reflexio. +https://github.com/ReflexioAI/claude-smart +``` + +## Suggested X reply for relevant conversations + +Only use when someone is explicitly discussing Claude Code memory, repeated agent mistakes, persistent context, or agent learning from corrections. + +```text +One useful distinction: memory stores what happened; learning stores what to do next time. + +claude-smart turns corrections/workflows into Preferences, Project-specific skills, and Shared skills that Claude Code, Codex, and OpenCode can reuse in future sessions. + +Repo: https://github.com/ReflexioAI/claude-smart +``` + +## Lightweight comparison-page outline + +Working title: `Claude Code memory vs learning: why corrections should become skills` + +1. **Problem:** transcript memory records context, but repeated mistakes persist when the next session lacks an actionable rule. +2. **Conceptual model:** + - Preference = how this project/user works. + - Project-specific skill = repo-local rule with trigger + rationale. + - Shared skill = cross-project pattern distilled from repeated evidence. +3. **Example:** user corrects a test command, dependency policy, or deployment caveat; show memory-style note vs skill-style rule. +4. **Why local matters:** data and learned artifacts stay on the developer’s machine; no extra external API call for semantic search per README. +5. **Proof point:** summarize the benchmark carefully and link `EXPERIMENT.md`; avoid overstating beyond the documented synthetic benchmark. +6. **Install CTA:** `npx claude-smart install` plus Codex/OpenCode variants. + +## Outreach guardrails + +- Do not claim hosted sync, team sharing, enterprise controls, or package registry status beyond what the repo states. +- Tie benchmark claims directly to `EXPERIMENT.md`; do not generalize to all real-world sessions. +- Prefer educational framing over promotional replies. +- Do not post on X/Twitter automatically. +- Avoid competitor attacks; frame as “memory vs learning” rather than “tool X is bad.” + +## Next owned-channel actions + +1. Convert the comparison-page outline into a short docs/blog page if the project has an approved publishing destination. +2. Post the first-party update in a project-owned GitHub Discussion or changelog channel after review. +3. Use the X post manually from Yi’s account when there is a relevant release/update moment. +4. Reuse the reply only in high-signal conversations where someone is already asking for Claude Code memory or agent learning.