version: "1.0.0" name: scaffold-utils description: >- Add or wire pure helpers/utils, preferring ArchiPy utils (datetime, JWT, password, file, string). Use for "add a helper/util function", "format dates", "hash passwords", or "generate tokens".

Scaffold ArchiPy Utils

Scope

Only helpers/utils/. Do not create decorators or interceptors here.

Read first

Read these plugin rules in full before generating files (paths relative to this skill directory; Claude Code: ${CLAUDE_SKILL_DIR}/../../rules/):

• ../../rules/using-archipy-utils.mdc

Before writing files

1. Inspect existing helpers and installed ArchiPy version for a matching utility.
2. Infer project naming and function/class style.
3. Ask only for an unresolved purpose or behavior. Prefer an ArchiPy utility whenever it fits.
4. Preserve existing helper modules; do not overwrite.

Prefer ArchiPy

If an ArchiPy util fits, show import + usage example and stop — do not duplicate. See ../archipy-docs/reference/helpers.md (Utils section), resolved relative to this SKILL.md's directory in the plugin installation — not the app workspace.

Custom util

Create helpers/utils/<name>_utils.py:

from __future__ import annotations
class SlugUtils:
    """Pure string helpers for URL-safe slugs — no I/O."""
    @staticmethod
    def slugify(value: str) -> str:
        """Return a lowercase hyphenated slug.
        Args:
            value: Raw display string.
        Returns:
            Slug suitable for path segments.
        """
        cleaned = "".join(ch.lower() if ch.isalnum() else "-" for ch in value.strip())
        while "--" in cleaned:
            cleaned = cleaned.replace("--", "-")
        return cleaned.strip("-")

• Pure functions/classes — no I/O, no DB, no adapters
• Google-style docstrings + full type hints
• Lazy-import optional deps inside functions when needed
• Brief usage snippet in the reply

Do not

• No adapter construction at module level; lazy-import optional deps inside functions when needed.

Verify

Run the repository's formatter, linter, and focused unit tests. Report the reused ArchiPy API or files created, plus commands run.

Docs

• https://syntaxarc.github.io/ArchiPy/tutorials/helpers/
• https://syntaxarc.github.io/ArchiPy/api_reference/
• Bundled skill reference: ../archipy-docs/reference/helpers.md (Utils section)