# Send Faces 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. 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. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "faces", "name": "Faces", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/sybileak/faces", "canonicalUrl": "https://clawhub.ai/sybileak/faces", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/faces", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=faces", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/REFERENCE.md", "references/SCOPE.md", "references/CONCEPTS.md", "references/OAUTH.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "faces", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T10:48:09.557Z", "expiresAt": "2026-05-08T10:48:09.557Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=faces", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=faces", "contentDisposition": "attachment; filename=\"faces-1.6.5.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "faces" }, "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/faces" }, "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/faces", "downloadUrl": "https://openagent3.xyz/downloads/faces", "agentUrl": "https://openagent3.xyz/skills/faces/agent", "manifestUrl": "https://openagent3.xyz/skills/faces/agent.json", "briefUrl": "https://openagent3.xyz/skills/faces/agent.md" } } ``` ## Documentation ### Faces Skill You have access to the faces CLI. Use it to fulfill any Faces Platform request. Always use --json when you need to extract values from command output. ### Current config !faces config:show 2>/dev/null || echo "(no config saved)" ### Setup Before running any command, verify credentials are available: faces config:show # see what's saved faces auth:whoami # confirm login works If no credentials exist and the user hasn't provided a key: For interactive sessions: run faces auth:login and prompt for email + password For API-key-only context: tell the user to set FACES_API_KEY= or run faces config:set api_key Install (if faces command not found): npm install -g faces-cli ### Auth rules Command groupRequiresfaces auth:*, faces keys:*JWT only — run faces auth:login firstEverything elseJWT or API key ### Core workflow Create a Face: faces face:create --name "Name" --username slug Compile source material into it — local files or YouTube URLs Sync to extract and embed cognitive primitives Chat through the Face: faces chat:chat slug -m "message" Compare Faces: faces face:diff or faces face:neighbors Compose new Faces from boolean formulas: faces face:create --formula "a | b" Boolean operators: | (union), & (intersection), - (difference), ^ (symmetric difference). Parentheses supported: (a | b) - c. ### Compile a document into a face DOC_ID=$(faces compile:doc:create --label "Notes" --file notes.txt --json | jq -r '.id') faces compile:doc:prepare "$DOC_ID" faces compile:doc:sync "$DOC_ID" --yes ### Upload a file (PDF, audio, video, text) faces face:upload --file report.pdf --kind document faces face:upload --file interview.mp4 --kind thread ### Import a YouTube video # Solo talk / monologue → document faces compile:import \\ --url "https://www.youtube.com/watch?v=VIDEO_ID" \\ --type document --perspective first-person # Then prepare and sync: faces compile:doc:prepare faces compile:doc:sync --yes # Multi-speaker → thread (no prepare step needed) faces compile:import \\ --url "https://youtu.be/VIDEO_ID" \\ --type thread --perspective first-person --face-speaker A faces compile:thread:sync If --type thread fails with a 422, retry with --type document. ### Create a composite face faces face:create --name "The Realist" --username the-realist \\ --formula "the-optimist | the-pessimist" # Chat through it like any other face faces chat:chat the-realist -m "How do you approach risk?" Composite faces are live: sync new knowledge into any component and the composite updates automatically. Components must be concrete (compiled) faces you own. ### Compare faces faces face:diff --face aria --face marco --face jin faces face:neighbors aria --k 3 faces face:neighbors aria --component beta --direction furthest --k 5 ### Chat with a specific LLM faces chat:chat slug --llm claude-sonnet-4-6 -m "message" faces chat:messages slug@claude-sonnet-4-6 -m "message" --max-tokens 512 faces chat:responses slug@gpt-4o -m "message" ### Billing and API keys faces billing:balance --json faces billing:subscription --json faces keys:create --name "Partner key" --face slug --budget 10.00 --expires-days 30 ### Common errors faces: command not found — Run npm install -g faces-cli. 401 Unauthorized — Credentials missing or expired. Run faces auth:login or check FACES_API_KEY. compile:doc:prepare returns "processing" — Extraction is async. Poll with faces compile:doc:get --json | jq '.status' until status is ready, then sync. 422 on thread import — No speaker segments detected. Retry with --type document. face:diff or face:neighbors returns null components — The face hasn't been synced yet. Run the compile+sync workflow first. ### References See references/REFERENCE.md for the full command reference, global flags, and environment variables. See references/CONCEPTS.md for a detailed explanation of what Faces is, how it works, and example use cases. See references/OAUTH.md for connecting a ChatGPT account (connect plan only). See references/SCOPE.md for instruction scope and security boundaries. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: sybileak - Version: 1.4.0 ## 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-01T10:48:09.557Z - Expires at: 2026-05-08T10:48:09.557Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/faces) - [Send to Agent page](https://openagent3.xyz/skills/faces/agent) - [JSON manifest](https://openagent3.xyz/skills/faces/agent.json) - [Markdown brief](https://openagent3.xyz/skills/faces/agent.md) - [Download page](https://openagent3.xyz/downloads/faces)