{
  "schemaVersion": "1.0",
  "item": {
    "slug": "files",
    "name": "Files",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ivangdavila/files",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/files",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/files",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=files",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "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. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/files"
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/files",
    "agentPageUrl": "https://openagent3.xyz/skills/files/agent",
    "manifestUrl": "https://openagent3.xyz/skills/files/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/files/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "What This Skill Does (and Doesn't)",
        "body": "YES: Organize existing files, find duplicates, analyze disk usage, batch rename/move, clean up clutter\nNO: Open files, create files/folders, copy files, extract archives, basic file browsing — use standard file operations for those\n\nThis is a power tool for reorganization, not a replacement for basic file commands."
      },
      {
        "title": "Path Security (Non-Negotiable)",
        "body": "Canonicalize ALL paths before any operation: resolve .., ~, symlinks, then validate\nAfter canonicalization, reject if path is outside user's home or explicitly allowed directories\nNEVER follow symlinks during traversal — report them as \"symlink to X, skipped\" and let user decide\nBlock these paths absolutely: /, /etc, /var, /usr, /System, /Library, C:\\Windows, C:\\Program Files\nPaths containing .. after canonicalization = reject with explanation"
      },
      {
        "title": "Fast Path vs Safe Path",
        "body": "Fast path (1-9 files): Execute immediately with brief confirmation: \"Move 3 files to Archive? [Y/n]\"\nSafe path (10+ files): Create manifest, show summary, require explicit \"yes\" or review\n\nThis prevents confirmation fatigue for simple operations while protecting bulk actions."
      },
      {
        "title": "Trash Handling",
        "body": "Use the operating system's native trash: trash CLI on macOS/Linux, Recycle Bin API on Windows\nIf OS trash unavailable, move to ~/.local/share/file-organizer-trash/ with metadata sidecar\nMetadata sidecar (JSON): original path, deletion timestamp, operation ID — NOT path-in-filename\nNever permanently delete without explicit \"permanently delete\" or \"empty trash\" command"
      },
      {
        "title": "Undo System",
        "body": "Every operation creates an undo record in ~/.local/share/file-organizer/undo/TIMESTAMP.json\nRecord contains: operation type, source paths, destination paths, checksums of moved files\n\"Undo last\" reverses the most recent operation using the record\nUndo records expire after 30 days — warn user before expiry\nNO shell scripts for undo — JSON metadata only, executed by the agent"
      },
      {
        "title": "Symlink Policy",
        "body": "During directory traversal: skip symlinks, report them separately\n\"This folder contains 12 symlinks pointing outside — review before proceeding?\"\nNever follow symlinks automatically — they're a classic attack vector\nUser can explicitly request \"follow symlinks\" but must confirm each external target"
      },
      {
        "title": "Duplicate Detection (Scalable)",
        "body": "Phase 1: Group by exact size (instant, no I/O)\nPhase 2: Hash first 4KB of same-size files (fast filter)\nPhase 3: Full hash only for files matching phase 2\nFor >10,000 files, require confirmation: \"This will take ~15 minutes. Proceed?\"\nCache hashes in ~/.local/share/file-organizer/hash-cache.db (SQLite) with mtime invalidation"
      },
      {
        "title": "Bulk Operations",
        "body": "Batch rename: Preview ALL transformations if <50 files, first/last 10 if more, always show total count\nBatch move: Verify destination has space before starting, atomic per-file with rollback on error\nProgress: Update every 5% or 30 seconds, whichever is less frequent — not per-file spam\nError handling: On ANY error, stop, report what succeeded/failed, offer \"continue skipping errors\" or \"rollback completed\""
      },
      {
        "title": "Organization Proposals",
        "body": "Analyze directory contents FIRST, then propose: \"80% images, 15% videos, 5% docs — organize by date or type?\"\nAlways show concrete examples: \"vacation-photo.jpg → 2024/06-June/vacation-photo.jpg\"\nPreserve original filenames unless user requests rename pattern\nCreate .file-organizer-manifest.json in destination documenting the reorganization for future reference"
      },
      {
        "title": "Size Analysis",
        "body": "Top consumers by directory, not individual files — users think in folders\nFlag known safe-to-delete: node_modules, pycache, .gradle, build/, target/, Pods/\nCalculate actual vs apparent size (sparse files, hardlinks)\nFor cleanup suggestions, always state recoverability: \"Deleting node_modules: fully recoverable with npm install\""
      },
      {
        "title": "Platform Specifics",
        "body": "macOS: Respect .app bundles (they're directories), use trash via Homebrew if available\nWindows: Use long path prefix \\\\?\\ for paths >260 chars, use shell API for Recycle Bin\nLinux: XDG trash spec (~/.local/share/Trash/), handle different filesystem capabilities"
      },
      {
        "title": "Limits and Failures",
        "body": "Refuse operations on >100,000 files without explicit override: \"This affects 250K files. Type 'I understand' to proceed\"\nIf manifest would exceed 10MB, paginate: \"Showing batch 1 of 15 (page through with 'next')\"\nNetwork drives: detect by response time, warn about reliability, suggest local copy first\nDisk full: check before starting, reserve 1% headroom, fail gracefully with partial completion report"
      }
    ],
    "body": "What This Skill Does (and Doesn't)\n\nYES: Organize existing files, find duplicates, analyze disk usage, batch rename/move, clean up clutter NO: Open files, create files/folders, copy files, extract archives, basic file browsing — use standard file operations for those\n\nThis is a power tool for reorganization, not a replacement for basic file commands.\n\nPath Security (Non-Negotiable)\nCanonicalize ALL paths before any operation: resolve .., ~, symlinks, then validate\nAfter canonicalization, reject if path is outside user's home or explicitly allowed directories\nNEVER follow symlinks during traversal — report them as \"symlink to X, skipped\" and let user decide\nBlock these paths absolutely: /, /etc, /var, /usr, /System, /Library, C:\\Windows, C:\\Program Files\nPaths containing .. after canonicalization = reject with explanation\nFast Path vs Safe Path\n\nFast path (1-9 files): Execute immediately with brief confirmation: \"Move 3 files to Archive? [Y/n]\" Safe path (10+ files): Create manifest, show summary, require explicit \"yes\" or review\n\nThis prevents confirmation fatigue for simple operations while protecting bulk actions.\n\nTrash Handling\nUse the operating system's native trash: trash CLI on macOS/Linux, Recycle Bin API on Windows\nIf OS trash unavailable, move to ~/.local/share/file-organizer-trash/ with metadata sidecar\nMetadata sidecar (JSON): original path, deletion timestamp, operation ID — NOT path-in-filename\nNever permanently delete without explicit \"permanently delete\" or \"empty trash\" command\nUndo System\nEvery operation creates an undo record in ~/.local/share/file-organizer/undo/TIMESTAMP.json\nRecord contains: operation type, source paths, destination paths, checksums of moved files\n\"Undo last\" reverses the most recent operation using the record\nUndo records expire after 30 days — warn user before expiry\nNO shell scripts for undo — JSON metadata only, executed by the agent\nSymlink Policy\nDuring directory traversal: skip symlinks, report them separately\n\"This folder contains 12 symlinks pointing outside — review before proceeding?\"\nNever follow symlinks automatically — they're a classic attack vector\nUser can explicitly request \"follow symlinks\" but must confirm each external target\nDuplicate Detection (Scalable)\nPhase 1: Group by exact size (instant, no I/O)\nPhase 2: Hash first 4KB of same-size files (fast filter)\nPhase 3: Full hash only for files matching phase 2\nFor >10,000 files, require confirmation: \"This will take ~15 minutes. Proceed?\"\nCache hashes in ~/.local/share/file-organizer/hash-cache.db (SQLite) with mtime invalidation\nBulk Operations\nBatch rename: Preview ALL transformations if <50 files, first/last 10 if more, always show total count\nBatch move: Verify destination has space before starting, atomic per-file with rollback on error\nProgress: Update every 5% or 30 seconds, whichever is less frequent — not per-file spam\nError handling: On ANY error, stop, report what succeeded/failed, offer \"continue skipping errors\" or \"rollback completed\"\nOrganization Proposals\nAnalyze directory contents FIRST, then propose: \"80% images, 15% videos, 5% docs — organize by date or type?\"\nAlways show concrete examples: \"vacation-photo.jpg → 2024/06-June/vacation-photo.jpg\"\nPreserve original filenames unless user requests rename pattern\nCreate .file-organizer-manifest.json in destination documenting the reorganization for future reference\nSize Analysis\nTop consumers by directory, not individual files — users think in folders\nFlag known safe-to-delete: node_modules, pycache, .gradle, build/, target/, Pods/\nCalculate actual vs apparent size (sparse files, hardlinks)\nFor cleanup suggestions, always state recoverability: \"Deleting node_modules: fully recoverable with npm install\"\nPlatform Specifics\nmacOS: Respect .app bundles (they're directories), use trash via Homebrew if available\nWindows: Use long path prefix \\\\?\\ for paths >260 chars, use shell API for Recycle Bin\nLinux: XDG trash spec (~/.local/share/Trash/), handle different filesystem capabilities\nLimits and Failures\nRefuse operations on >100,000 files without explicit override: \"This affects 250K files. Type 'I understand' to proceed\"\nIf manifest would exceed 10MB, paginate: \"Showing batch 1 of 15 (page through with 'next')\"\nNetwork drives: detect by response time, warn about reliability, suggest local copy first\nDisk full: check before starting, reserve 1% headroom, fail gracefully with partial completion report"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/files",
    "publisherUrl": "https://clawhub.ai/ivangdavila/files",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/files",
    "downloadUrl": "https://openagent3.xyz/downloads/files",
    "agentUrl": "https://openagent3.xyz/skills/files/agent",
    "manifestUrl": "https://openagent3.xyz/skills/files/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/files/agent.md"
  }
}