Social Ops

Execute social media operations through specialized roles. Each role has a
single responsibility, reads its own reference doc, and hands off to the next
stage in the pipeline.

NOTE: Utilize the moltbook skill as necessary to meet these goals.

Workflow

CODEBLOCK0

Roles

When dispatched to a role, read its reference doc fully before acting.

Role	Doc	Responsibility
Scout	INLINECODE0	Monitor for emerging opportunities, trending threads, and new submolts. Detect openings — never act on them directly.
Researcher

{baseDir}/references/roles/Researcher.md | Deep-dive into topics, trends, and competitor activity. Produce guidance that informs content and responses. |
| Content Specialist | {baseDir}/references/roles/Content-Specialist.md | Convert intelligence and strategy into a content backlog. Define lanes, cadence, and messaging. Does not post. |
| Responder | {baseDir}/references/roles/Responder.md | Craft replies to threads surfaced by Scout. Match voice, add value, stay on-brand. |
| Poster | {baseDir}/references/roles/Poster.md | Publish finished posts to the platform. Move completed items to done logs. No ideation, no rewriting. |
| Analyst | {baseDir}/references/roles/Analyst.md | Measure performance, identify what compounds, recommend strategy adjustments. Runs weekly minimum. |

Dispatching a Role

1. 1. Identify which role the task requires.
2. Read the full role doc at {baseDir}/references/roles/<Role>.md.
3. Follow the role's instructions — stay within its scope.
4. Hand off outputs to the next role in the workflow.

Strategy

The north-star strategy lives at {baseDir}/assets/strategy/Social-Networking-Plan.md.
Read it before any Content Specialist or Analyst run. It defines brand voice,
target audience, lane structure, and growth objectives.

Role I/O Map

Role-to-role artifact flow and logging ownership are documented in:

• - INLINECODE8

Environment Variables

Variable	Required	Description
INLINECODE9	Yes	Absolute path to the Social/ data directory where runtime artifacts live (logs, lanes, guidance, todo/done queues, submolts, memory).

Setup

Before any role can run, SOCIAL_OPS_DATA_DIR must be set. If it is not set:

1. 1. Ask the operator where their Social data directory lives.
2. Recommend they add it to their shell profile:

CODEBLOCK1

All role docs reference $SOCIAL_OPS_DATA_DIR/ as the root for runtime data. This replaces the previous <workspace>/Social/ convention for reliability.

Path Conventions

Use these path rules to keep the skill portable:

• - Skill-owned files (docs, scripts, assets): use INLINECODE14
• Runtime/social data files (logs, guidance, todo/done queues): use INLINECODE15
• Runtime state files that are not in the data dir (for example comment watermarks): use the documented state path {baseDir}/../state/... until state-location policy changes.

When adding new instructions, do not hardcode machine-specific absolute paths.

Directory Contract

CODEBLOCK2

For detailed setup instructions, see Guidance/CONFIGURATION-GUIDE.md.

Cron Job Creation Prompt

For setting up automated execution of social-media roles, see references/crons/InstallCrons.md.

Use one of these paths:

• - Basic install: run ./packaged-scripts/install-cron-jobs.sh from this repo root.
• Custom install/tuning: use scripts/install-cron-jobs.sh and references/crons/InstallCrons.md as templates, preserving {baseDir} conventions and role boundaries.