concinno-skills-office

Local Office document skills for Concinno. Native Python libraries, no Microsoft 365 / Graph API round-trip, no network.

Status

MVP (0.1.0) — five tools covering the core four-quadrant of local Office document creation:

Future versions will extend the existing tools (images, styles, more chart types) without bumping Concinno itself. A separate concinno-skills-office-365 sibling package will host the Microsoft Graph API path when it ships; this package will never gain a cloud dependency.

Install

pip install concinno-skills-office

All five document libraries are hard dependencies — pulled in automatically. The package is useless without them.

License notes

The package itself is Apache-2.0. However docxtpl is licensed under LGPL-2.1. We depend on it as a pip dependency — a dynamic link — so the re-link rights the LGPL requires are preserved for any downstream consumer that pip-installs Office skills the normal way.

If you statically bundle this package into a single-file binary (e.g. PyInstaller with --onefile) the bundle's redistribution terms must satisfy LGPL-2.1 §6 for the docxtpl code path specifically. The upstream docxtpl project lives at https://github.com/elapouya/python-docx-template.

Safety

Every tool validates its output_path / template_path kwarg before touching disk:

1. Must be a non-empty string.
2. After Path.resolve() it must live under either Path.home() or Path.cwd().
3. It may not live under a well-known system root (/etc, /Windows, /System, /Program Files, …) — guards against the HOME=/ edge case.

Violations return {"error": "..."} rather than writing the file.

Usage via Concinno ToolRegistry

When the consumer sets CONCINNO_LOAD_PLUGINS=1, the default registry auto-mounts all five tools:

import os
os.environ["CONCINNO_LOAD_PLUGINS"] = "1"

from concinno.tools.registry import get_default_registry

reg = get_default_registry()
for name in (
    "WordCreate",
    "ExcelWrite",
    "ExcelChart",
    "PptCreate",
    "DocxTemplate",
):
    assert name in reg.list_deferred()

Direct Python usage

from concinno_skills_office import (
    WordCreate, ExcelWrite, ExcelChart, PptCreate, DocxTemplate,
)

# Word: heading + paragraphs + a table.
WordCreate().call(
    action="create",
    output_path="./report.docx",
    heading="Quarterly Report",
    paragraphs=["Summary paragraph.", "Details below."],
    tables=[[["Metric", "Value"], ["Revenue", "$1.2M"]]],
)

# Excel: rows + formula.
ExcelWrite().call(
    action="create",
    output_path="./sheet.xlsx",
    sheet="Sales",
    rows=[
        ["Name", "Units", "Total"],
        ["A", 10, "=B2*5"],
        ["B", 20, "=B3*5"],
    ],
)

# Excel + chart.
ExcelChart().call(
    action="create",
    output_path="./chart.xlsx",
    sheet="Data",
    rows=[["Q1", 10], ["Q2", 20], ["Q3", 15], ["Q4", 30]],
    chart={
        "type": "bar",
        "title": "Quarterly",
        "categories": "A1:A4",
        "values": "B1:B4",
    },
)

# PowerPoint.
PptCreate().call(
    action="create",
    output_path="./deck.pptx",
    slides=[
        {"title": "Agenda", "content": ["Intro", "Body", "Q&A"]},
        {"title": "Outro", "content": ["Thanks."]},
    ],
)

# Docx template render.
DocxTemplate().call(
    action="render",
    template_path="./letter_template.docx",
    context={"name": "Alice", "date": "2026-04-22"},
    output_path="./letter_alice.docx",
)

All tools return either {"ok": True, ...} on success or {"error": "..."} on any validation or library failure — matching the shape of other Concinno built-in tools.

License

Apache-2.0. See LICENSE in the Concinno monorepo.