cuecards: Skill for Claude Code

Repomix

Repomix packs repositories into AI-friendly artifacts for read-only reference work.

This is a helper skill only.

• Do use it for research, audits, source comparison, documentation context, bug investigation prep, and feature-porting prep.
• Do not use it to create plans, decide execution scope, or bypass RIPER approval.
• Do not write outputs into plan-control folders like process/general-plans/active/ or process/features/*/active/.

When To Use

Use this skill when you need:

• a local repo snapshot for LLM review
• a remote GitHub repo pack without cloning it deeply
• a focused module pack for debugging or architectural comparison
• a documentation or API-context pack
• a security-oriented repository review artifact
• a reusable reference artifact for a later helper such as xia

If the task only needs a few files, ordinary rg plus targeted reads is cheaper than repomix.

Output Policy

Generated artifacts belong in Flowser references/ folders only:

• General or cross-cutting work:
  • process/general-plans/references/
• Feature-scoped work:
  • process/features/{feature}/references/

Keep outputs flat by default unless the user explicitly asks for a dedicated subfolder.

Suggested filenames:

• repomix-{topic}-{dd-mm-yy}.xml
• repomix-{topic}-{dd-mm-yy}.md
• repomix-{topic}-{dd-mm-yy}.txt
• repomix-{topic}-{dd-mm-yy}.json

Prefer a short topic slug over a generic output name.

Install And Invocation

Use pnpm-aligned commands:

pnpm dlx repomix --version

Default no-install path:

pnpm dlx repomix . --style markdown -o process/general-plans/references/repomix-snapshot-27-05-26.md

For repeat usage in one session, direct repomix CLI is fine if already installed and approved by the user. Otherwise prefer pnpm dlx.

Do not default to npm install -g. Do not default to clipboard-first flows.

Common Flows

1. Local scoped pack

pnpm dlx repomix . \
  --include "apps/flowser/src/**/*.tsx,packages/ui/src/**/*.tsx,process/context/**/*.md" \
  --ignore "**/*.test.*,coverage/**" \
  --remove-comments \
  --style markdown \
  -o process/general-plans/references/repomix-ui-context-27-05-26.md