📦

agent-fs

Name: agent-fs
Author: desplega-ai

Revisão do conteúdo r1 Risco Médio ⚙️ Comandos externos🌐 Acesso à rede📁 Acesso ao sistema de arquivos🔑 Variáveis de ambiente

Manage Versioned Files with agent-fs

Agent workflows need persistent files that remain searchable and traceable across changes. This skill guides agent-fs operations for storage, search, version history, collaboration, and SQL queries.

Suporta: Claude Codex Code(CC)

⚠️ 50 Ruim

Instalar com meu Agente

Copie esta solicitação para o seu Agente. Ela inclui a página canônica do Skill e o manifesto.

Solicitação do agente

Review the Skillstore skill "agent-fs" from https://skillstore.io/skills/desplega-ai-agent-fs.md and its manifest at https://skillstore.io/api/skills/desplega-ai-agent-fs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Seu Agente ainda deve apresentar o plano e solicitar qualquer confirmação exigida pela política de segurança.

Recursos legíveis por agentes

Use estes links quando um agente de IA, crawler ou script precisar de contexto limpo em vez de ler a página completa.

Detalhe em Markdown GET /skills/desplega-ai-agent-fs.md manifest assinado GET /api/skills/desplega-ai-agent-fs/manifest lockfile assinado GET /api/skills/desplega-ai-agent-fs/lockfile

Testar

Usando "agent-fs". Explain how sharing a report differs between S3 and local storage.

Resultado esperado:

S3 produces a presigned link that anyone holding it can use until expiration.
Local storage produces an authenticated application link that requires drive membership and does not expire.
Use the shortest practical expiration for presigned links and keep them out of logs.

Usando "agent-fs". How should I update a document without overwriting a teammate's changes?

Resultado esperado:

Confirm the organization and drive, then read the document and its current version.
Submit the update with the expected version and a descriptive version message.
If the version check fails, review the newer content before retrying.

Auditoria de segurança

Risco Médio

v1 • 28/09/2026 Abrir o relatório versionado

Most static findings are Markdown delimiters, documented application operations, or scoped authentication examples rather than malicious behavior. Six findings identify risky FUSE permission changes and forced system configuration replacement; one additional finding covers S3 credentials exposed through command arguments. No evidence found of prompt injection or intentional credential exfiltration; external CLI implementations were not included in this review.

Arquivos analisados

495

Linhas analisadas

Itens de revisão

Falsos positivos ignorados

Preocupações de segurança confirmadas (1)

Médio

SKILL.md:61

S3 Onboarding Exposes Credentials Through Command Arguments

The onboarding example passes credentials through --s3-access-key and --s3-secret-key without a handling warning. Following it can expose keys in process arguments, shell history, or recorded agent commands.

The example explicitly places both credentials in command arguments. Unlike the remote-mount guidance, this workflow gives no warning about argument-based credential exposure.

Itens de revisão de capacidade (6)

Estas são capacidades locais reais que podem ser esperadas para esta habilidade, portanto exigem revisão, mas não são contabilizadas como comportamento malicioso confirmado.

Alto

SKILL.md:455

sudo privilege escalation

sudo chmod 666 /dev/fuse

The unconditional chmod 666 grants every local user device read and write access. It can weaken existing restrictions without checking sandbox isolation.

Alto

SKILL.md:456

sudo privilege escalation

sudo ln -sf /proc/mounts /etc/mtab

The command force-replaces /etc/mtab as root without inspecting its current state. This can disrupt existing mount-table configuration on systems requiring a different setup.

Alto

SKILL.md:457

sudo privilege escalation

echo user_allow_other | sudo tee -a /etc/fuse.conf

Appending user_allow_other globally enables unprivileged users to request cross-user FUSE access. The shown mount does not need this policy relaxation.

Alto

SKILL.md:456

Linux /proc filesystem access

sudo ln -sf /proc/mounts /etc/mtab

The risk is force-replacing /etc/mtab as root with a /proc/mounts link, not reading process secrets. No existing-configuration check protects this system change.

Alto

SKILL.md:455

Non-standard device file access

sudo chmod 666 /dev/fuse

The device operation makes /dev/fuse writable by all local users. Unconditional permission broadening can defeat a deployment's existing device-access restrictions.

Alto

SKILL.md:456

Symlink creation

sudo ln -sf /proc/mounts /etc/mtab

The root-level ln -sf can replace an existing /etc/mtab entry without checking whether replacement is appropriate. This risks disrupting host mount-table configuration.

Fatores de risco

⚙️ Comandos externos (50)

🌐 Acesso à rede (5)

SKILL.md:422 SKILL.md:433 SKILL.md:436 SKILL.md:437 SKILL.md:460

📁 Acesso ao sistema de arquivos (13)

SKILL.md:50 SKILL.md:63 SKILL.md:270 SKILL.md:459 SKILL.md:50 SKILL.md:63 SKILL.md:265 SKILL.md:270 SKILL.md:459 SKILL.md:456 SKILL.md:259 SKILL.md:455 SKILL.md:456

🔑 Variáveis de ambiente (7)

SKILL.md:75 SKILL.md:76 SKILL.md:75 SKILL.md:76 SKILL.md:76 SKILL.md:270 SKILL.md:461

Auditado por: codex

Compartilhar e citar este relatório

Compartilhe o relatório de avaliação versionado, o badge neutro, o cartão incorporável e as citações. A Skillstore apresenta evidências sem decidir se este Skill é seguro.

Abrir o relatório versionado

Copiar link do relatório

https://skillstore.io/skills/desplega-ai-agent-fs/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Badge Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/desplega-ai-agent-fs/security.svg)](https://skillstore.io/skills/desplega-ai-agent-fs?utm_source=security_passport_badge)

Badge HTML

<a href="https://skillstore.io/skills/desplega-ai-agent-fs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/desplega-ai-agent-fs/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Cartão incorporável

<iframe src="https://skillstore.io/embed/skills/desplega-ai-agent-fs.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Citações acadêmicas (APA · BibTeX · CFF)

Citação APA

desplega-ai. (2026). agent-fs security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/desplega-ai-agent-fs/audits/1

Citação BibTeX

@techreport{desplega-ai-desplega-ai-agent-fs-2026,
  author = {desplega-ai},
  title = {agent-fs security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/desplega-ai-agent-fs/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "agent-fs security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "desplega-ai"
date-released: "2026-09-28"
url: "https://skillstore.io/skills/desplega-ai-agent-fs/audits/1"
identifiers:
  - type: other
    value: "skillstore:desplega-ai-agent-fs:audit:1"
    description: "Skillstore immutable audit report identifier"

Pontuação do Skillstore

Por que esta pontuação Confiança das evidências: Médio

Arquitetura

Manutenibilidade

Conteúdo

Comunidade

Conformidade com a especificação

O que você pode criar

Persist Agent Project Files

Store project documents, check the target drive, and track revisions with version messages and concurrency checks.

Analyze Stored Business Data

Join stored datasets and summarize results with DuckDB while checking row limits and truncation.

Coordinate Shared Documents

Review comments, inspect recent activity, and manage approved drive memberships with explicit roles.

Teste estes prompts

List Files in a Drive

Show my current agent-fs organization and drive, then list files under [folder]. Do not change anything.

Store a Versioned Document

Save [document] to [path] in agent-fs organization [org] and drive [drive]. Check the current version and use a concurrency guard when updating.

Find and Compare Related Documents

Search drive [drive] in organization [org] for [topic]. Summarize relevant files and compare the latest two versions of [path] without modifying them.

Join Stored Datasets

Query [dataset A] and [dataset B] in agent-fs drive [drive] within organization [org]. Join on [key], calculate [metric], and report truncation and assumptions.

Boas práticas

Confirm organization and drive scope before writes, searches, membership changes, or sharing.
Use expected-version checks for updates and include descriptive version messages.
Protect credentials and sharing links, and review privileged FUSE setup before approving system changes.

Evitar

Running sandbox setup commands unchanged on shared hosts or production systems.
Putting real credentials into command arguments, shared logs, or agent transcripts.
Assuming every sharing link is public or every storage backend supports identical expiration behavior.

Perguntas frequentes

Can I use this skill with Claude, Codex, or Claude Code?

Yes, the listing supports all three tools. Executing operations requires access to an installed and configured agent-fs CLI.

Do I need Docker or S3?

No. The local filesystem backend stores versioned file bytes on disk without Docker or S3.

Does semantic search work without embeddings?

Semantic results require embeddings. Hybrid search identifies keyword-only results when semantic retrieval is unavailable.

Are generated sharing links private?

S3 presigned links grant access to anyone holding them until expiration. Local-backend links require an authenticated drive member.

What data can I query with SQL?

The guide covers CSV, TSV, Parquet, XLSX, JSON, NDJSON, SQLite, and DuckDB. Database files require table bindings; results have row limits.

Can I mount drives on every operating system?

No. FUSE mounting requires Linux, device access, and system capabilities. Review privileged setup commands before running them.

Detalhes do desenvolvedor

Autor

desplega-ai

Licença

MIT

Revisão da Skillstore

Aviso de versão

O autor não declarou uma versão.

Repositório

https://github.com/desplega-ai/agent-fs/tree/a99dd72351b674fb2288dfbf1f21b2b250a1f3a8/skills/agent-fs

Referência

bad9dafc37d1638cd29cb9bab06d5f8dbcd0f6c2

Atualidade da manutenção

30/09/2026

Uso

0 downloads · 0 visualizações

Estrutura de arquivos

📄 SKILL.md