Skip to content

cynco-labs/ai-accounting-skills / accounting-engagement/skills/engagement-setup

engagement-setup

Verified

Write engagement_state and workspace for a known client/period. Use when new engagement or setup books.

/engagement-setup

Purpose

Lock in engagement context after (or with) document-first discovery.

Preconditions

  1. shared/guardrails.md
  2. shared/operator-lens.md
  3. Firm profile if present (defaults only)
  4. If folder dump / unknown entity → run smart-intake first, then return here to formalize

Route

SituationAction
User gave legal name + period + clear docsSetup directly (below)
User: “accounting for this folder” / no namesmart-intake first
engagement_state.json existsresume-engagement

Workflow

1. Scan client folder

Banks, invoices, payslips, prior FS, SSM, tax files. Prefer facts from files over questions.

2. Entity identification

From SSM / bank account title / prior FS / smart-intake inferences:

  • Legal name, registration number (only if on a doc — never invent)
  • Entity type
  • Address / activities if present

Load references/entity_types.md or jurisdiction pack.

3. Framework selection (derive, don’t quiz)

EntityFrameworkTax form
Berhad (public)MFRSForm C
Sdn BhdMPERSForm C
PLTMPERSForm PT
Sole propAccrual S21AForm B
PartnershipAccrual S21AForm P
KoperasiMCAForm TF
TrustVariesForm TP

Only ask if entity type is still ambiguous after docs.

4. Financial year

Prefer statement date coverage + prior FS. Soft-confirm if incomplete year.

5. Completeness (honest, not scary)

Blockers for full-year final FS:

  • Full-year bank statements (or accepted limited period)
  • Clear reporting entity identity

Not first-turn questions — note as gaps:

  • Payslips, FAR, inventory, loans, prior FS

6. COA

Entity template + optional industry overlay from payee patterns (trading vs services). Soft default; user rarely needs to choose.

7. Operator + depth on state

Set operator and engagement_type (shared/operator-lens.md):

  • Infer from language + firm profile, or one soft-ask if missing
  • Default depth for thin setup: bookkeeping_only unless user asked year-end / tax

8. README + engagement_state.json

Per references/engagement_state.schema.json and shared/agent-runtime.md.

Include:

## Inferences
| Field | Value | Confidence | Evidence |

Required on state: operator, engagement_type (and classify_depth when known).

9. Engagement card

# Engagement: [Legal name]
- Operator: owner | bookkeeper | firm
- Depth: bookkeeping_only | year_end | …
- Entity / framework / tax form
- FY / coverage limitations
- Status: ready | provisional | blocked
- Next: extract banks → classify → …

Question budget

After smart-intake, setup should usually ask zero new questions. If something critical is still open, ≤2 questions total (operator counts if still unknown).

Completion

Done when: workspace exists, engagement_state.json valid against schema, entity/period/framework/operator/depth recorded (may be provisional).

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall