- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add nanocoai/nanoclaw --skill add-anydoc -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add nanocoai/nanoclaw --skill add-anydoc -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add nanocoai/nanoclaw --skill add-anydoc -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add nanocoai/nanoclaw --skill add-anydoc -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/nanocoai/nanoclaw/tree/HEAD/.claude/skills/add-anydoc來自發布者
Install one pinned CLI and one focused container skill. Keep document conversion inside the agent container; do not change NanoClaw's attachment pipeline or add credentials, an MCP server, or a hosted parser.
Read CONTRIBUTING.md, docs/skill-guidelines.md, and the supply-chain section of docs/SECURITY.md.
Run this check against the official npm registry before changing files:
curl -fsSL "https://registry.npmjs.org/@firecrawl%2Fanydoc" | node -e '
let body = "";
process.stdin.setEncoding("utf8");
process.stdin.on("data", (chunk) => (body += chunk));
process.stdin.on("end", () => {
const metadata = JSON.parse(body);
const version = "0.1.6";
const release = metadata.versions?.[version];
const publishedAt = Date.parse(metadata.time?.[version] ?? "");
const eligibleAt = publishedAt + 72 * 60 * 60 * 1000;
if (!release) throw new Error(`${version} is missing from the registry`);
if (release.deprecated) throw new Error(`${version} is deprecated: ${release.deprecated}`);
if (!Number.isFinite(publishedAt)) throw new Error(`missing publish time for ${version}`);
if (Date.now() < eligibleAt) throw new Error(`${version} is gated until ${new Date(eligibleAt).toISOString()}`);
console.log(`${version} passed the 72-hour release gate`);
});
'
Stop on any failure. Do not install a PR commit, add a minimumReleaseAgeExclude, enable lifecycle scripts, or silently substitute another version, unless the user explicitly approves it.
Inspect container/cli-tools.json for @firecrawl/anydoc before changing files:
0.1.6: leave it unchanged.Check whether container/skills/convert-documents-to-markdown/SKILL.md and src/anydoc-manifest.test.ts already exist. Reapplying this skill overwrites only those dedicated files.
If data/v2.db exists, inspect per-group image pins before changing files. Standard derived images can be rebuilt from the updated shared image. Stop and report any other pin because its owner must decide how to rebuild it:
if [ -f data/v2.db ]; then
source setup/lib/install-slug.sh
image_base="$(container_image_base)"
foreign=0
while IFS='|' read -r group_id image_tag package_count; do
[ -z "$group_id" ] && continue
if [ "$image_tag" != "${image_base}:${group_id}" ]; then
echo "Foreign image pin: $group_id -> $image_tag" >&2
foreign=1
elif [ "$package_count" -eq 0 ]; then
echo "Derived image cannot be rebuilt: $group_id has no configured packages" >&2
foreign=1
elif ! ncl groups get --id "$group_id" >/dev/null; then
echo "Cannot reach NanoClaw through ncl for derived image: $group_id" >&2
foreign=1
fi
done < <(pnpm exec tsx scripts/q.ts data/v2.db \
"SELECT agent_group_id, image_tag, COALESCE(json_array_length(packages_apt), 0) + COALESCE(json_array_length(packages_npm), 0) FROM container_configs WHERE image_tag IS NOT NULL ORDER BY agent_group_id")
[ "$foreign" -eq 0 ]
fi
Resolve this skill's bundled files from either Claude Code's skill variable or the project skill directory, then copy both files:
project_root="$(git rev-parse --show-toplevel)"
skill_dir="${CLAUDE_SKILL_DIR:-$project_root/.claude/skills/add-anydoc}"
test -f "$skill_dir/container-skills/convert-documents-to-markdown/SKILL.md"
test -f "$skill_dir/anydoc-manifest.test.ts"
mkdir -p container/skills/convert-documents-to-markdown
cp "$skill_dir/container-skills/convert-documents-to-markdown/SKILL.md" \
container/skills/convert-documents-to-markdown/SKILL.md
cp "$skill_dir/anydoc-manifest.test.ts" src/anydoc-manifest.test.ts
If the manifest has no AnyDoc entry, append this exact object to its JSON array. Do not add onlyBuilt; the package and its prebuilt Linux bindings have no install lifecycle script.
{ "name": "@firecrawl/anydoc", "version": "0.1.6" }
Run validation before building the image:
pnpm exec vitest run src/anydoc-manifest.test.ts container/cli-tools.test.ts
pnpm run build
./container/build.sh
If pnpm rejects the package as too new, stop. Do not bypass the release-age policy.
Rebuild standard per-group images so groups with custom packages inherit the updated shared image:
if [ -f data/v2.db ]; then
source setup/lib/install-slug.sh
image_base="$(container_image_base)"
while IFS='|' read -r group_id image_tag; do
[ -z "$group_id" ] && continue
if [ "$image_tag" != "${image_base}:${group_id}" ]; then
echo "Foreign image pin appeared during install: $group_id -> $image_tag" >&2
exit 1
fi
ncl groups restart --id "$group_id" --rebuild
done < <(pnpm exec tsx scripts/q.ts data/v2.db \
"SELECT agent_group_id, image_tag FROM container_configs WHERE image_tag IS NOT NULL ORDER BY agent_group_id")
fi
Resolve this install's image name and exercise the native binding, not only the help path:
source setup/lib/install-slug.sh
image="$(container_image_base):latest"
docker run --rm --entrypoint anydoc "$image" --version
printf 'name,count\nalpha,2\n' | \
docker run --rm -i --entrypoint anydoc "$image" - --format csv | grep -q alpha
docker run --rm --entrypoint sh "$image" -c 'command -v timeout'
If timeout is absent, remove its wrapper from the installed container skill; do not add another dependency. Convert local DOCX, PPTX, and XLSX fixtures when available. Do not add private or large binary fixtures to the repository.
Restart this NanoClaw service only, so its running containers stop and default skills: "all" groups receive the new shared skill on their next spawn:
source setup/lib/install-slug.sh
# macOS
launchctl kickstart -k "gui/$(id -u)/$(launchd_label)"
# Linux
systemctl --user restart "$(systemd_unit)"
Run only the command for the current platform. If NanoClaw is not service-managed, stop this install's running agent containers by their nanoclaw-install=<install-slug> label instead of matching every nanoclaw-v2 container on the host.
Use one real channel attachment and verify the complete path:
/workspace/inbox/<message-id>/<file>, and use that exact path./workspace/agent/converted/ and summarize only the relevant Markdown sections.CONTAINER_MEMORY_LIMIT; AnyDoc's parser caps decompression, but NanoClaw containers have no memory limit by default.Report that office documents now convert locally. Call out that scanned PDFs need OCR, embedded visuals may be incomplete, and spreadsheet Markdown is not authoritative for calculations.
Add local office-document-to-Markdown conversion to NanoClaw agent containers with the pinned Firecrawl AnyDoc CLI. Use when agents need to read attached Word, PowerPoint, Excel, OpenDocument, RTF, EP
---name: add-anydocdescription: Add local office-document-to-Markdown conversion to NanoClaw agent containers with the pinned Firecrawl AnyDoc…---# .claude/skills/add-anydoc/SKILL.md總覽
Add local office-document-to-Markdown conversion to NanoClaw agent containers with the pinned Firecrawl AnyDoc CLI. Use when agents need to read attached Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, or text-based PDF files without uploading them to a hosted parser.
常見問題
從發布者下載 .claude/skills/add-anydoc/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/nanocoai/nanoclaw。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。