Home / deckflow / deckuse · skills/deckuse/SKILL.md · GitHub

deckuse SKILL.md skillA

deckuse from deckflow/deckuse is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it. Use when inspecting, creating, modifying, automating, or verifying PowerPoint (PPTX) or Word (DOCX) documents with the Deckuse CLI. Covers workspace management, semantic targeting, batch mutations with apply, layout alignment, rich text blocks, tables, charts, and visual rendering checks.

Kind
SKILL.md skill
Repository
deckflow/deckuse
Path
skills/deckuse/SKILL.md
Audit grade
A, 17 of 17 checks passed
Versions recorded
15
Latest version
git:20261009.aa465bd, committed Oct 9, 2026
First version recorded
Sep 12, 2026
Size
14,070 bytes
Repository stars
109
License
AGPL-3.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Deckuse Agent Skill

**Requires CLI `deckuse >= 1.3.0` (edition=community).** Check with `deckuse --version`. If older, upgrade before following recipes below (`new` and recent apply/units features).

Deckuse is a local-first, schema-driven Office document automation engine for coding agents. It treats PPTX files as versioned workspaces, provides stable semantic addresses (`slide:N/shape:ID`), applies surgical atomic mutations, and tracks history via Git revisions.

Prefer **`deckuse schema --type addShape --json`** (or full `deckuse schema --json`) over guessing fields from memory.

---

## 1. Core Operating Principles for AI Agents

1. **Workspace-First Architecture**:
   Never edit `.pptx` in-place. Use `deckuse new ./ws --json` (bundled blank template) or `deckuse init input.pptx ./ws --json` (existing file). Mutations update `source/`, commit via Git, append `.deckuse/operations.jsonl`, and rebuild `./ws/package.pptx`.
2. **Batch Mutations via `apply`**:
   Do **NOT** run many individual write CLIs. Each write = one revision + recompress. Prefer one JSON batch:
   ```bash
   deckuse apply --workspace ./ws --input ops.json --json
   ```
…

Read the whole file at its exact version.

How to install

Latest version
mdr add deckflow/deckuse/deckuse@git:20261009.aa465bd
Exact content
mdr add deckflow/deckuse/deckuse@sha256:24c9a99446f1b927

Pin to a label like 1.0.0, or to a sha256 fingerprint for the exact contents. Either way, the exact version is written to mdr.lock. mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_sdttcmxuuoovj6ca.svg)](https://markdownregistry.com/a/art_sdttcmxuuoovj6ca)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 15 versions of this file, between Sep 12, 2026 and Oct 9, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261009.aa465bd latest2026-10-09 aa465bd 14,070 BA view · diff
git:20261009.94e98bc2026-10-09 94e98bc 14,086 BA view · diff
git:20261003.c4457142026-10-03 c445714 13,574 BA view · diff
git:20260928.cd3dd022026-09-28 cd3dd02 13,643 BA view · diff
git:20260926.acbf5dd2026-09-26 acbf5dd 13,647 BA view · diff
git:20260926.2127b232026-09-26 2127b23 13,459 BA view · diff
git:20260924.9b4861f2026-09-24 9b4861f 13,171 BA view · diff
git:20260920.1470c1f2026-09-20 1470c1f 13,135 BA view · diff
git:20260918.0ab477d2026-09-18 0ab477d 9,438 BA view · diff
git:20260918.01cc29f2026-09-18 01cc29f 8,515 BA view · diff
git:20260918.681f56f2026-09-18 681f56f 8,305 BA view · diff
git:20260915.2deecaa2026-09-15 2deecaa 8,077 BA view · diff
git:20260915.7345e4d2026-09-15 7345e4d 6,375 BA view · diff
git:20260912.02f30512026-09-12 02f3051 11,643 BA view · diff
git:20260912.a60dfc32026-09-12 a60dfc3 9,167 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14070 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

deckflow/deckuse · 109 stars · license AGPL-3.0 · pushed 2026-10-10 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_sdttcmxuuoovj6ca
GET https://markdownregistry.com/api/v1/resolve?ref=deckflow/deckuse/deckuse
GET https://markdownregistry.com/api/v1/blob/24c9a99446f1b927b3b8b91bb21f9c85023490bb7f6282dab675a8b0de94c686

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from deckflow/deckuse

format-text-files Cursor rule
deckflow/deckuse · .cursor/rules/format-text-files.mdc · 保存文本文件时使用可 diff 的格式化输出(JSON、XML 等)
git:20260828.26a765a · audit A · 109 stars
no-cursor-attribution Cursor rule
deckflow/deckuse · .cursor/rules/no-cursor-attribution.mdc · Never add Cursor attribution trailers to git commits or PRs
git:20260810.0cbdb72 · audit A · 109 stars

Every file in deckflow/deckuse

Browse by kind, by grade A, or by owner.