{"skill":{"slug":"yf-memo","displayName":"yf-memo","summary":"Personal memo and todo management system. Use when user expresses intent related to remembering, tracking, or managing tasks.","description":"---\nname: yf-memo\ndescription: Personal memo and todo management system. Use when user expresses intent related to remembering, tracking, or managing tasks.\nhomepage: https://github.com/openclaw/openclaw\nmetadata:\n  openclaw:\n    emoji: 📝\n    os: [\"darwin\", \"linux\"]\n    requires: { \"bins\": [\"bash\"] }\n    install:\n      - id: \"copy-files\"\n        kind: \"manual\"\n        steps:\n          - \"Place the entire yf-memo directory into ~/.openclaw/skills/\"\n          - \"Ensure scripts are executable: chmod +x scripts/*.sh\"\n---\n\n# 🗂️ Personal Memo System Skill\n\nA personal task tracking system integrated with OpenClaw workspace. The AI assistant uses this skill when it recognizes the user wants to manage tasks, reminders, or to-dos through natural conversation.\n\n## Core Principle: Intent-Based Activation\n\n**DO NOT** implement fixed command patterns like specific phrase matching to specific actions.\nAvoid binding exact user phrases to script calls.\n\n**INSTEAD** the AI should:\n1. **Understand user intent** through natural language\n2. **Decide if task tracking is appropriate**\n3. **Use the appropriate script functions**\n4. **Respond conversationally**\n\n## When to Consider Using This Skill\n\nThe AI assistant should consider using this skill when the user's request falls into these intent categories:\n\n### Intent Category: Memory Delegation\nThe user wants the assistant to remember or track something for them.\n- \"I need to remember to submit the report tomorrow\"\n- \"Can you note that I have a meeting at 3pm?\"\n- \"Remind me to buy groceries after work\"\n\n**AI Reasoning**: User is asking me to serve as a memory aid for future actions.\n\n### Intent Category: Status Inquiry  \nThe user wants to know what tasks are pending or need attention.\n- \"What do I have on my plate right now?\"\n- \"Show me what's left to do today\"\n- \"Are there any outstanding tasks I should handle?\"\n\n**AI Reasoning**: User is seeking a summary of pending responsibilities.\n\n### Intent Category: Progress Tracking\nThe user indicates something has been completed or finished.\n- \"I finished writing that document\"\n- \"The meeting with the client is done\"\n- \"Item number 2 on my list is complete\"\n\n**AI Reasoning**: User is providing status update that should be recorded.\n\n### Intent Category: Accomplishment Review\nThe user wants to review what has been accomplished.\n- \"What have I completed so far this week?\"\n- \"Show me a summary of finished tasks\"\n- \"Let me see what I've gotten done today\"\n\n**AI Reasoning**: User wants retrospective view of completed work.\n\n## System Integration\n\n### File Structure\n```\n~/.openclaw/workspace/\n├── pending-items.md          # Auto-numbered pending tasks\n├── completed-items.md        # Timestamped completed tasks\n└── skills/yf-memo/scripts/\n    ├── memo-helper.sh        # Core management functions\n    └── daily-summary.sh      # Automatic daily summaries\n```\n\n### Script Functions\n\n**Finding the Script Location**:\nSince skill installation paths vary per user, use these methods to locate the scripts:\n\n**Method 1: Dynamic Path Discovery (Recommended)**\n```bash\n# Find skill directory by name (yf-memo)\nSKILL_DIR=$(find ~/.openclaw/skills ~/.openclaw/workspace/skills -name \"yf-memo\" -type d 2>/dev/null | tail -1)\nMEMO_SCRIPT=\"$SKILL_DIR/scripts/memo-helper.sh\"\nsh \"$MEMO_SCRIPT\" add \"task description\"\n```\n\n**Method 2: Consistent Relative Path Pattern**\nIf the AI assistant is already in the OpenClaw workspace context:\n```bash\nsh ./skills/yf-memo/scripts/memo-helper.sh add \"task description\"\n```\n\n**Method 3: Use Environment Variable Setup**\nFirst, set up these environment variables in shell profile:\n```bash\n# Add to .zshrc or .bashrc\nexport YFMEMO_SKILL_DIR=\"$HOME/.openclaw/skills/yf-memo\"\nexport YFMEMO_SCRIPT=\"$YFMEMO_SKILL_DIR/scripts/memo-helper.sh\"\n```\nThen use:\n```bash\nsh \"$YFMEMO_SCRIPT\" add \"task description\"\n```\n\n**Available Functions** (using dynamic location):\n- Add new task: `sh \"$MEMO_SCRIPT\" add \"item description\"`\n- Mark task X as complete: `sh \"$MEMO_SCRIPT\" complete-number X`\n- Mark matching task as complete: `sh \"$MEMO_SCRIPT\" complete-content \"partial text\"`\n- Display pending tasks: `sh \"$MEMO_SCRIPT\" show-todos`\n- Display completed tasks: `sh \"$MEMO_SCRIPT\" show-done`\n\n**daily-summary.sh** - For scheduled daily summaries (located in same scripts directory)\n\n## AI Assistant Guidelines\n\n### Memory Delegation Flow\n1. Recognize user wants to delegate memory of a task\n2. Extract the task description from natural language\n3. Execute: `sh \"$MEMO_SCRIPT\" add \"task description\"`\n4. Respond with confirmation including assigned number\n\n**Example interaction**:\n```\nUser: \"I should remember to call the dentist tomorrow\"\nAI Reasoning: User wants me to remember this task for them\nAI Action: sh \"$MEMO_SCRIPT\" add \"call the dentist tomorrow\"\nAI Response: \"✅ I've added that as item 3: call the dentist tomorrow\"\n```\n\n### Status Inquiry Flow\n1. Recognize user wants to see pending tasks\n2. Execute: `sh \"$MEMO_SCRIPT\" show-todos`\n3. Present results conversationally\n\n**Example interaction**:\n```\nUser: \"What's still on my todo list?\"\nAI Reasoning: User wants to see pending tasks\nAI Action: sh \"$MEMO_SCRIPT\" show-todos\nAI Response: Cool, I'll check... <shows results>\n```\n\n### Progress Tracking Flow\n1. Recognize user is reporting task completion\n2. Determine if completion refers to item number or content\n3. Execute appropriate completion command\n4. Confirm the completion\n\n**Example interaction**:\n```\nUser: \"I finished that report\"\nAI Reasoning: User saying a task is done\nAI Action: sh \"$MEMO_SCRIPT\" complete-content \"report\"\nAI Response: \"✅ Marked that as complete!\"\n```\n\n## Important Notes for AI\n\n### Language Flexibility\n- Support both Chinese and English expressions\n- Don't fixate on exact phrases\n- Focus on intent over specific wording\n\n### User Experience\n- Always confirm actions clearly\n- Include the item number in responses when applicable\n- Keep responses natural, not robotic\n\n### Error Handling\n- If a task isn't found, explain clearly\n- Offer to show current list if there's confusion\n- Suggest alternative actions when appropriate\n\n## Sample Conversations\n\n### Conversation 1: Natural Task Addition\n```\nUser: \"Oh, I need to email Sarah about the project update\"\nAI: \"✅ I'll track that for you. Added as item 2: email Sarah about project update\"\n```\n\n### Conversation 2: Checking Status\n```\nUser: \"What's still outstanding?\"\nAI: \"Let me check... You have 2 pending items...\"\n```\n\n### Conversation 3: Mixed Language\n```\nUser: \"我刚刚完成了第三件事\"\nAI: \"✅ Marked item 3 as completed!\"\n```\n\n### Conversation 4: Implicit Request\n```\nUser: \"有哪几件事需要我今天处理？\"\nAI: \"Here's what's on your pending list...\" \n```\n\n## Development Philosophy\n\nThis skill embodies the principle that AI assistants should:\n- Understand intent, not just parse commands\n- Adapt to natural human conversation patterns\n- Provide value through contextual understanding\n- Maintain conversation flow organically\n\nThe system exists to support the assistant in helping the user manage tasks, not to enforce rigid interaction patterns.\n\n---\n\n*This skill enables natural task management through conversational AI.*\n","topics":["Personal"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":617,"installsAllTime":23,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773542336706,"updatedAt":1778999883576},"latestVersion":{"version":"1.0.0","createdAt":1773542336706,"changelog":"yf-memo 1.0.0\n\n- Initial release of personal memo and todo management skill for OpenClaw.\n- Supports intent-based task tracking, completion, and review through natural conversation.\n- Handles addition, completion, status inquiry, and accomplishment review of tasks.\n- Flexible language support (Chinese and English); prioritizes user intent over fixed commands.\n- Installation and script usage instructions provided, including dynamic path handling.","license":"MIT-0"},"metadata":{"setup":[],"os":["darwin","linux"],"systems":null},"owner":{"handle":"yfsong0709","userId":"s17c99apz30j4169dd2yc6qj01885w9v","displayName":"Yi-Fan Song","image":"https://avatars.githubusercontent.com/u/17495679?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089890843}}