dimagi-internal/ace / skills/gdoc-writer
gdoc-writer
VerifiedPublish an ad-hoc ACE deliverable (not an opp run) as a Google Doc under ACE's Drive root, Projects/<project>/.
Google Doc Writer — ACE (stub over the shared canopy gdoc engine)
The convert → file → share → verify mechanism is canopy's shared engine; the filing standard
is $CANOPY/agent-core/deliverables.md (one subfolder per project, never My Drive root,
share and verify before handing over a link, link don't paste). This stub declares only
ACE's specifics.
Not for opp runs. A run's artifacts live under ACE/<opp>/runs/<run>/ and are reached
through the run's ace-web page (CLAUDE.md § Conventions). This is for work outside a run,
e.g. a demo's scripts doc that people edit together.
ACE specifics
-
Author:
config/agent.json(ace@dimagi-ai.com, clientcanopy); run from an ACE checkout or pass--repo <ACE root>. -
Root:
$GDRIVE_ROOT_FOLDER, a value in ACE's Canopy vault on canopy-web, written into the installed plugin's.envby/ace:setup --force-env. It is NOT in the shell environment, so read that one key from the.envin the same Bash call as the publish (shell state does not persist between calls), and neversourcethe file: its values carry shell metacharacters, so sourcing it errors and prints fragments of stored passwords into the transcript (ace#3421):ACE_ENV="$HOME/.claude/plugins/data/ace-ace/.env" CANOPY_ROOT="$(bash "$(python3 -c "import json,os;print(json.load(open(os.path.expanduser('~/.claude/plugins/installed_plugins.json')))['plugins']['canopy@canopy'][0]['installPath'])")/scripts/canopy-runtime.sh")" GDRIVE_ROOT_FOLDER="$(grep -E '^GDRIVE_ROOT_FOLDER=' "$ACE_ENV" | cut -d= -f2- | tr -d "'\"")"; export GDRIVE_ROOT_FOLDER uv run --project "$CANOPY_ROOT" canopy gdoc publish --repo . \ --md <file.md> --name "<Doc title>" --project "<Project>" --share none # iterate in place: --replace <docId> (same link, same permissions) -
"no Drive root resolved" means the installed
.envpredates this key. Run/ace:setup --force-env, which keeps local-only secrets, and never paste a folder id in to work around it. -
Sharing is an outbound act. In a manual-mode turn, publish with
--share none, then share the doc with named people only after the operator approves the send. Confirm each person appears in the permission list before you hand over the link (gog drive permissions <docId> -a ace@dimagi-ai.com --client "$(canopy email client --repo .)" -j).
Terminology
Every string this skill puts in front of a reader follows
skills/_terminology.md: Connect, never CommCare Connect, and
US spelling, always — program, enrollment, enroll, organization, behavior, center; never
programme, enrolment, organisation (owner, 2026-10-20: "everything should be US spelling",
ace#3232). Identifiers (case properties, slugs, ids, config keys) keep their spelling.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |