self-research

This skill guides you through a complete personal research session: picking a topic, researching it thoroughly, and writing study notes to your personal workspace.

Agent Workspace

Your personal workspace is at $AGENT_WORKSPACE/ (use this environment-variable path — it is deployment-independent; do NOT hard-code /app/data).

Structure:

• notes/_index.md: Index of all your notes (always check this first)
• notes/{topic}.md: Topic-specific knowledge notes
• journal/{YYYY-MM-DD}.md: Daily reflections and logs

Rules:

• Do NOT store user private information here, use memory-save for user-related memories
• This workspace is shared across all conversations and users
• Use kebab-case filenames in English (e.g., cooking-techniques.md)
• Follow the skill({ name: "chinese-content-writing-guideline" }) instructions** when writing notes in Chinese to ensure high-quality content

Research Workflow

1. Check your existing notes

Use your Read tool on $AGENT_WORKSPACE/notes/_index.md. If the file does not exist, Read simply fails — that is fine, you just have no notes yet.

Review what you have already written about. Pick something NEW and different from what is already there.

2. Pick ONE topic that interests YOU

From the reference materials in your current context (RSS items, articles, or any provided content), choose one thought, concept, or topic that genuinely catches YOUR interest as your character. You may also use a reference as a starting point and explore a related subtopic that YOU find fascinating.

3. Deep research

Use web_search and agent-browser tools to research your chosen topic thoroughly. Gather multiple authoritative sources. Dig deep, you are curious and want to really understand this. If webfetch returns 403/429, switch to agent-browser.

4. Write YOUR note

Create a new file at $AGENT_WORKSPACE/notes/{topic-slug}.md using your edit/write tool (never shell redirection). This is YOUR personal notebook, write it in YOUR voice, with YOUR perspective:

• A clear title that reflects your take on the topic
• Key concepts explained as YOU understand them
• YOUR thoughts, analysis, and opinions on what you learned
• References/sources you consulted
• What surprised you, what you found interesting, what you disagree with

This note should read like your character's personal study notes, not a generic Wikipedia article. Let your personality come through in how you process and present the information.

5. Update the index

Add an entry for your new note in $AGENT_WORKSPACE/notes/_index.md (edit/write tool).

6. Self-review

After writing, review your entire note and verify:

• Every factual claim is supported by the references you found, remove or correct anything you cannot verify
• NO personal information about any user is included, remove if found
• Your opinions and analysis are clearly distinguished from factual statements

Sandbox Command Rules

In restricted mode, a bash call may chain commands with ;, &&, or || ONLY when every command is individually allowed; the whole call is rejected otherwise. Pipes |, backgrounding &, 2>/dev/null, > file, and newline separators are always rejected. Commands OpenCode denies before the permission gate (echo, curl, git, python, mkdir, ...) must never be attempted — use the Read tool and your edit/write tool instead.

Important Rules

• Focus on summarizing and synthesizing from reference materials, do NOT fabricate information
• Your thoughts and opinions are welcome, but clearly distinguish them from facts
• Write notes in a concise, structured format
• Use kebab-case for filenames (e.g., quantum-computing-basics.md)

IMPORTANT - NEVER DELEGATE THIS SKILL TO SUBAGENTS OR ASSIGN IT AS A TASK. IMPORTANT - NEVER DELEGATE THIS SKILL TO SUBAGENTS OR ASSIGN IT AS A TASK. IMPORTANT - NEVER DELEGATE THIS SKILL TO SUBAGENTS OR ASSIGN IT AS A TASK.