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.

FileKindSize
SKILL.mdskill md3.2 KB
---
name: engagement-setup
description: >
  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

| Situation | Action |
|---|---|
| User gave legal name + period + clear docs | Setup directly (below) |
| User: “accounting for this folder” / no name | **`smart-intake` first** |
| `engagement_state.json` exists | `resume-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)

| Entity | Framework | Tax form |
|---|---|---|
| Berhad (public) | MFRS | Form C |
| Sdn Bhd | MPERS | Form C |
| PLT | MPERS | Form PT |
| Sole prop | Accrual S21A | Form B |
| Partnership | Accrual S21A | Form P |
| Koperasi | MCA | Form TF |
| Trust | Varies | Form 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:

```markdown
## Inferences
| Field | Value | Confidence | Evidence |
```

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

### 9. Engagement card

```markdown
# 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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall