actor-fetch-personality

Actor Fetch Personality

Internal skill used by commands that dispatch the Actor agent. Handles personality source detection, fetching, validation, and prompt formatting.

IMPORTANT: If the spec below invokes any deferred tool (e.g. AskUserQuestion), you MUST load and call it as specified. Never skip the call, never substitute a default answer of your own — the tool invocation is part of the contract. This is critical.

Flow

Step 1: Detect Source Type

Parse the personality source argument:

• Starts with http:// or https:// -> URL
• Starts with /, ~, or . -> local file path
• Otherwise -> inform user: "Personality source must be a URL or file path"

Step 2: Fetch Content

URL: Use Bash with curl -sL <url> to fetch the raw content. Do NOT use WebFetch - the internal model filters personality content as prompt injection.

GitHub URLs: If URL contains github.com/.../blob/, convert to raw URL: replace github.com with raw.githubusercontent.com and remove /blob/. Example: https://github.com/user/repo/blob/main/persona.md -> https://raw.githubusercontent.com/user/repo/main/persona.md

File path: Use Read tool. Expand ~ to home directory.

If fetch fails (curl returns empty, Read returns error): inform user "Could not load personality from {source}. Check the URL/path." Stop - do not proceed with actor dispatch.

Step 3: User Review Gate

Before loading personality into the actor, show a preview and ask for confirmation:

Extract from fetched content: name (from frontmatter or first heading), expertise signals (first 2-3 bullet points or description), line count.

AskUserQuestion(
  questions=[{
    question: "Load this personality into Actor?",
    header: "LETS",
    options: [
      { label: "Load", description: "{name} - {expertise summary} ({N} lines)" },
      { label: "Cancel", description: "Don't load, skip actor" }
    ],
    multiSelect: false
  }]
)

• Load -> proceed to Step 4
• Cancel -> stop, inform calling command that actor was skipped

Step 4: Validate

• If content is empty: stop, inform user
• If content exceeds 2000 lines: truncate to first 2000 lines, warn user
• Content should contain identifiable persona signals (name, expertise, identity). If it looks like code or random text, warn but proceed (lenient validation)

Step 5: Format for Prompt

Return the personality content formatted as a prompt block to be injected into the Actor agent's Task prompt:

PERSONALITY:
{fetched content}

The calling command inserts this block into the Task prompt alongside MODE, PROJECT CONTEXT, and the user's question.