file

SOCIAL.md

Project-root config that gives every social-share skill the same defaults

Discovery: resolves at $PWD first, then the git root — works from any subdirectory
Optional load: parsed only when present; every section and value is optional
Named ## sections: Defaults, Identity, Focus, Avoid, Audience, Examples
Soft defaults: share-time flags like --platform always override the file
Generated for you by /social-media-tools:share-init — no hand-authoring needed

Set your repo's social voice once — and every post inherits it.

That's SOCIAL.md in the agentics plugin marketplace: a plain-Markdown config at the project root that hands every social-media-tools skill the same defaults — platform, tone, hashtags, focus topics, and what to never share.

How it works:
- Skills look for it at your current dir first, then fall back to the git root, so it resolves from anywhere in the repo.
- Named ## sections parse into variables: ## Defaults sets platform + tone + hashtags, ## Avoid filters out things like .env files, ## Focus shapes the copy angle.
- Defaults are soft — a share-time flag like --platform always wins. Less friction, no loss of control.
- You don't hand-author it: /social-media-tools:share-init analyzes the codebase and writes it for you.

The design choice that makes it nice: convention over configuration. No JSON schema, no YAML to get wrong — just readable Markdown that stays diff-friendly in your repo.

Follow for more Claude Code plugin patterns like this.

#ClaudeCode #DeveloperTools #AITools #Automation

Twitter/X

SOCIAL.md: one plain-Markdown file at your repo root that gives every social-share skill the same defaults — platform, tone, hashtags, and what to never post.

Soft defaults, never locks: a --platform flag always overrides.

#ClaudeCode #DevTools

Bluesky

Neat pattern in agentics by Shawn Sandy: SOCIAL.md — a plain-Markdown file at your repo root that gives every social-share skill the same defaults (platform, tone, hashtags, exclusions).

Convention over config. Set it once with share-init; override any value at share time.

Substack

A design decision in the agentics marketplace worth borrowing: SOCIAL.md.

It hands every social-sharing skill the same defaults — platform, tone, hashtags, and what to never share. The trick is the format: plain Markdown with named sections, not JSON or YAML — human-editable and diff-friendly.

The principle: defaults reduce friction, never remove control. Any value is overridable at share time — config as a starting point, not a cage.

Follow for more Claude Code design notes.