# Send Mini Diary to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mini-diary",
    "name": "Mini Diary",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/PrintXDreams/mini-diary",
    "canonicalUrl": "https://clawhub.ai/PrintXDreams/mini-diary",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mini-diary",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mini-diary",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "package.json",
      "README.md",
      "SKILL.md",
      "test_security.sh",
      "templates/diary_template.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mini-diary",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T10:44:19.845Z",
      "expiresAt": "2026-05-09T10:44:19.845Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mini-diary",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mini-diary",
        "contentDisposition": "attachment; filename=\"mini-diary-0.1.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mini-diary"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mini-diary"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mini-diary",
    "downloadUrl": "https://openagent3.xyz/downloads/mini-diary",
    "agentUrl": "https://openagent3.xyz/skills/mini-diary/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mini-diary/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mini-diary/agent.md"
  }
}
```
## Documentation

### 📓 Mini Diary Skill

Your AI-powered mini diary. Small footprint, smart features.

### ✨ Features

📝 Simple Daily Logging: Clean Markdown format with date, weather, notes, and todos
🏷️ Smart Auto-Tagging: AI analyzes content and adds relevant tags automatically
🔍 Powerful Search: Search by tags, date, or content with context
📊 Basic Statistics: Tag frequency and completion rate tracking
☁️ Cloud Sync Ready: Optional NextCloud integration with detailed guide
🔓 Open Format: Plain Markdown files - you own your data

### Installation

# Install via ClawHub
clawhub install mini-diary

### Basic Usage

# Add a note (auto-tagging happens automatically)
mini-diary add "Met with client about P1S delivery"

# Add a todo item (use [ ] for pending, [x] for completed)
# The todo will be added to the current day's todo section
echo "- [ ] Follow up with supplier" >> ~/diary.md
echo "- [x] Submit monthly report" >> ~/diary.md

# Search by tag
mini-diary search --tag "📦"

# Search by date
mini-diary search --date "2024-02-22"

# Search in content
mini-diary search "client meeting"

# View statistics
mini-diary search --stats

# List all available tags
mini-diary search --list-tags

### 📁 Diary Format

Mini Diary uses a simple Markdown format:

# 📓 My Diary

## 📅 2024-02-22 Thursday

### 📝 Notes

- Met with client about P1S delivery 📦🎋
- Fixed heating issue on X1C printer 🔧🎋
- Submitted monthly invoice 💰

### ✅ Todos

- [ ] Follow up with supplier
- [x] Update inventory spreadsheet

### Adding Todos

Since todos are simple Markdown task lists, you can add them directly:

# Add a pending todo
echo "- [ ] Call client for follow-up" >> ~/diary.md

# Add a completed todo  
echo "- [x] Submit weekly report" >> ~/diary.md

# Add multiple todos
cat >> ~/diary.md << 'EOF'
- [ ] Order more filament
- [x] Backup server data
- [ ] Schedule team meeting
EOF

### Todo Best Practices

Start with date: Ensure you're adding to the correct day's section
Use clear descriptions: "Call John re: P1S delivery" not just "Call John"
Update status: Change [ ] to [x] when completed
Review daily: Check todos at start/end of each day

### Finding Todos

# Search for pending todos
grep "\\[ \\]" ~/diary.md

# Search for completed todos
grep "\\[x\\]" ~/diary.md

# Count todos by status
grep -c "\\[ \\]" ~/diary.md  # Pending count
grep -c "\\[x\\]" ~/diary.md  # Completed count

### 🏷️ Auto-Tagging System

The AI automatically adds tags based on content:

TagMeaningExample Triggers🏠Familyhome, family, household💰Financeinvoice, payment, accounting📦Orderorder, purchase, stock🚚Shippingshipping, delivery, logistics💻Techsoftware, system, computer🔧Supportrepair, fix, issue, problem🎋Bambubambu, 3d print, printer📋Formform, report, data, spreadsheet📅Daily(default for routine notes)

### Setup

Set environment variable:

export NEXTCLOUD_SYNC_DIR="/path/to/nextcloud/diary"

Mini Diary will automatically sync to this directory.

### ⚠️ Important Notes

File Permissions: NextCloud requires specific file ownership:

# After copying files to NextCloud directory:
chown www-data:www-data /path/to/diary.md

# Or using Docker:
docker exec nextcloud_app chown www-data:www-data /var/www/html/data/...

Scan Command Required: NextCloud won't detect changes automatically:

docker exec nextcloud_app php occ files:scan [username]

### Environment Variables

# Diary file location
export DIARY_FILE="$HOME/my-diary.md"

# NextCloud sync directory
export NEXTCLOUD_SYNC_DIR="/path/to/nextcloud"

# Custom tag definitions (JSON file)
export TAGS_CONFIG="/path/to/tags.json"

### Custom Tags

Create a JSON file to define custom tags:

{
  "custom_tags": {
    "project-x": "🚀",
    "urgent": "⚠️",
    "meeting": "👥"
  },
  "rules": {
    "project-x": ["project x", "px", "feature"],
    "urgent": ["urgent", "asap", "important"],
    "meeting": ["meeting", "call", "discussion"]
  }
}

### Weekly Report

# Generate weekly summary
mini-diary search --date $(date -d "last week" +%Y-%m-%d) --stats

### Tag Analysis

# See most used tags
mini-diary search --stats | grep -A5 "Tag Statistics"

### Export Data

# Export to CSV for analysis
grep "^- " diary.md | sed 's/^- //' > notes.csv

### Common Issues

Tags not appearing: Check content keywords match tag rules
NextCloud files not showing: Did you run the scan command?
Permission errors: Check file ownership in NextCloud directory
Search not working: Ensure diary file exists and has content

### Debug Mode

# Enable debug output
export MINI_DIARY_DEBUG=1
mini-diary add "test note"

### 🤝 Contributing

Found a bug? Have a feature request? Contributions welcome!

Fork the repository
Create a feature branch
Submit a pull request

### 📄 License

MIT License - see LICENSE file for details.

### 🙏 Acknowledgments

Built with OpenClaw
Inspired by real-world need for simple, smart journaling
Thanks to all contributors and users

Mini Diary - Because journaling should be simple, smart, and yours.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: PrintXDreams
- Version: 0.1.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T10:44:19.845Z
- Expires at: 2026-05-09T10:44:19.845Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mini-diary)
- [Send to Agent page](https://openagent3.xyz/skills/mini-diary/agent)
- [JSON manifest](https://openagent3.xyz/skills/mini-diary/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mini-diary/agent.md)
- [Download page](https://openagent3.xyz/downloads/mini-diary)