Skip to content
Skills Library
Documents & office · Conversion & formats

wafflebase-docs

/wafflebase-docs

Use for Wafflebase word-processor docs and markdown notes — reading or summarizing a doc, turning repository files into a doc or note, editing doc or note text, DOCX import/export, PDF export. Load the core `wafflebase` skill first for setup, links and the write protocol.

Repository
wafflebase ↗
Licence
Apache-2.0
Last repository change
28.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Use for Wafflebase word-processor docs and markdown notes — reading or summarizing a doc, turning repository files into a doc or note, editing doc or note text, DOCX import/export, PDF export. Load the core `wafflebase` skill first for setup, links and the write protocol.

Original author description

Use for Wafflebase word-processor docs and markdown notes — reading or summarizing a doc, turning repository files into a doc or note, editing doc or note text, DOCX import/export, PDF export. Load the core `wafflebase` skill first for setup, links and the write protocol.

How it works

  1. Reading
  2. Creating
  3. Editing a note
  4. Editing a doc
  5. Export
  6. References
Original SKILL.md headings · 84 lines, 428 words
SKILL.md preview
---
name: wafflebase-docs
description: Use for Wafflebase word-processor docs and markdown notes — reading or summarizing a doc, turning repository files into a doc or note, editing doc or note text, DOCX import/export, PDF export. Load the core `wafflebase` skill first for setup, links and the write protocol.
---

# Wafflebase Docs and Notes

Follow the core `wafflebase` skill's read and write protocol. Exact
flags: `wafflebase schema docs.<command>` / `notes.<command>`.

Two document types, two different editing stories:

| | Doc (`type: doc`) | Note (`type: note`) |
| --- | --- | --- |
| Is | Paginated rich-text document | One Markdown text |
| Read | `docs content <id> --format md` | `notes content <id> --format md` |
| Create from a file | `docs import file.docx` | `notes import file.md` |
| Edit text | Whole replace of the JSON tree (see below) | `notes import edited.md --replace <id>` |

When the user wants to publish Markdown from the repository, a **note**
is the faithful target. Only use a doc when they ask for one (or for a
DOCX).

## Reading

```bash
wafflebase docs content <id> --format md --pages 1-3     # a slice of a long doc
wafflebase docs content <id> --format text               # cheapest to read
wafflebase notes content <id> --format md
```

Read page ranges of long docs rather than the whole thing.

## Creating

```bash
wafflebase notes import README.md --title "Release notes 0.7"
wafflebase docs import proposal.docx --title "Proposal"
wafflebase docs create "Meeting notes" --type doc        # empty doc
```

## Editing a note

Write the edited Markdown to a file, then replace — after a backup copy:

```bash
wafflebase notes content <id> --format md --out note.md   # current text
# … edit note.md …
wafflebase docs copy <id>                                  # restore point
wafflebase notes import note.md --replace <id> --yes       # only after the user approved
```

## Editing a doc

There is no partial-edit command for docs yet: every text edit replaces
the whole document tree, which overwrites anything a collaborator typed
meanwhile. Keep it deliberate:

1. Say exactly which paragraphs will change and confirm the user wants
   the edit applied rather than suggested.
2. `wafflebase docs copy <id>` — restore point; give the user its link.
3. `wafflebase docs content <id> --format json --out doc.json`.
4. Change only the blocks that need changing in `doc.json`; leave every
   other block byte-identical.
5. `wafflebase docs set-content <id> < doc.json` — or `--data`.

For a small change the user can make faster in the editor, offer the link
and the exact suggested wording instead — a suggestion is often the
better answer than a whole replace.

## Export

```bash
wafflebase docs export <id> out.pdf [--pages 1-3]
wafflebase docs export <id> out.docx
wafflebase notes export <id> note.md
```

## References

- [references/docs-manage.md](../../references/docs-manage.md)
- [references/docs-read-content.md](../../references/docs-read-content.md)
- [references/docs-import-docx.md](../../references/docs-import-docx.md)
- [references/docs-export-docx.md](../../references/docs-export-docx.md)
- [references/docs-export-pdf.md](../../references/docs-export-pdf.md)
- [references/recipe-doc-to-markdown.md](../../references/recipe-doc-to-markdown.md)
- [references/recipe-docx-to-pdf.md](../../references/recipe-docx-to-pdf.md)

Versions

The database has no other skills named wafflebase-docs.

Database snapshot: 13.11.2026 · package version 3d10ab05663c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100wafflebase
    Use when the user asks about their Wafflebase documents — finding, reading, summarizing, creating, editing, moving, copying, commenting on or deleting a Wafflebase sheet, doc, slide deck, note, board or file. Covers setup, finding documents, the read and write protocol, links,…
  • 100wafflebase-slides
    Use for Wafflebase slide decks — reading or summarizing a deck, adding, duplicating, reordering or deleting slides, building a deck from a PPTX, PPTX export. Load the core `wafflebase` skill first for setup, links and the write protocol.
  • 95doc-to-markdown
    Doc to Markdown - convert Word (.doc/.docx) documents to clean Markdown using MinerU. Use when converting Word files to Markdown for reading or editing.
  • 90doc-processor
    当用户要生成 Word/Excel/PowerPoint、做文档格式转换(Markdown ↔ HTML ↔ DOCX ↔ PDF)、PDF 文本提取、读写 Excel、合并文档或批量转换时使用。
  • 100docx
    Complete DOCX document creation, editing, and analysis capabilities with support for revisions, comments, formatting preservation, and text extraction. Also handles Word format conversion: legacy .doc → .docx, DOCX → PDF, DOCX → images (PNG/JPG) for visual review or previews,…
  • 90doc
    Extract/OCR/convert PDF/DOCX/XLSX with local CLIs. Use when a document needs text, OCR, page merge/split or DOCX export.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.