aifs-space_skill

Overview

This skill integrates with AIFS.space to store and retrieve files via a simple REST API. It lets agents persist notes, documents, and non-sensitive data to the cloud and sync files across sessions. Use it when you need lightweight, file-oriented cloud storage with basic access control.

How this skill works

The skill calls AIFS.space endpoints using an API key sent in the Authorization header (Bearer token). It supports listing files, reading full files or line ranges, writing new files (auto-creates directories), patching specific lines, deleting files, and fetching a 500-character summary. Rate limits and permission types (admin, read-write, read-only, write-only) are enforced by the API and surfaced via standard headers and error codes.

When to use it

• Persist session notes or chat transcripts between interactions
• Save and share documents or small datasets between agents
• Sync configuration, project notes, or simple backups across sessions
• Retrieve specific file sections (line ranges) without downloading whole files
• Avoid for sensitive content—do not store secrets, PII, or regulated data

Best practices

• Require the user to supply an AIFS API key; prefer environment or user config for storage
• Check key permissions before write/patch/delete operations to avoid FORBIDDEN errors
• Respect rate limits (60 requests/minute) and read X-RateLimit headers to back off
• Keep directory depth under 20 to avoid DEPTH_EXCEEDED errors
• Use summary or line-range reads for large files to minimize bandwidth and latency

Example use cases

• Save daily agent session notes to sessions/YYYY-MM-DD.md and retrieve them later
• Maintain a project folder structure (projects/<name>/README.md, notes.md) for collaboration between agents
• Append to a shared log by reading, appending text, then writing the updated file back
• Patch configuration snippets by replacing specific line ranges without rewriting whole files
• Fetch a 500-character preview of a long document before deciding to download it fully