@gonzih/skills-accounting 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 gonzih
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,36 @@
1
+ # skills-accounting
2
+
3
+ Claude Code skills for accountants, CPAs, and bookkeepers.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npx @gonzih/skills-accounting
9
+ ```
10
+
11
+ Then restart Claude Code.
12
+
13
+ ## Skills
14
+
15
+ | Skill | Invoke | What it does |
16
+ |---|---|---|
17
+ | `tax-memo` | `/tax-memo` | Write a tax research memo: issue, facts, law, analysis, conclusion, client summary |
18
+ | `client-advisory-letter` | `/client-advisory-letter` | Write a client advisory letter: plain-language explanation, implications, recommended actions |
19
+ | `audit-finding-summary` | `/audit-finding-summary` | Summarize an audit finding: condition, criteria, cause, effect, recommendation, management response template |
20
+ | `engagement-letter` | `/engagement-letter` | Draft an engagement letter: scope, fees, timing, client responsibilities, standard terms |
21
+
22
+ ## Usage examples
23
+
24
+ ```
25
+ /tax-memo Does our client's home office qualify for the Section 280A deduction?
26
+
27
+ /client-advisory-letter The new beneficial ownership reporting requirements under the Corporate Transparency Act
28
+
29
+ /audit-finding-summary We found 12 of 40 purchase orders lacked required dual approval signatures
30
+
31
+ /engagement-letter Prepare a 2025 Form 1120S for an S-corp client, fixed fee
32
+ ```
33
+
34
+ ## License
35
+
36
+ MIT
package/install.js ADDED
@@ -0,0 +1,15 @@
1
+ #!/usr/bin/env node
2
+ import { copyFileSync, mkdirSync, existsSync } from 'fs';
3
+ import { join } from 'path';
4
+ import { homedir } from 'os';
5
+
6
+ const skillsDir = join(homedir(), '.claude', 'skills');
7
+ const skills = ['tax-memo', 'client-advisory-letter', 'audit-finding-summary', 'engagement-letter'];
8
+
9
+ for (const skill of skills) {
10
+ const dest = join(skillsDir, skill);
11
+ if (!existsSync(dest)) mkdirSync(dest, { recursive: true });
12
+ copyFileSync(new URL(`./skills/${skill}/SKILL.md`, import.meta.url).pathname, join(dest, 'SKILL.md'));
13
+ console.log(`✓ Installed /${skill}`);
14
+ }
15
+ console.log('\nSkills installed! Restart Claude Code to use them.');
package/package.json ADDED
@@ -0,0 +1,33 @@
1
+ {
2
+ "name": "@gonzih/skills-accounting",
3
+ "version": "1.0.0",
4
+ "description": "Claude Code skills for accountants, CPAs, and bookkeepers: tax-memo, client-advisory-letter, audit-finding-summary, engagement-letter",
5
+ "type": "module",
6
+ "bin": {
7
+ "skills-accounting": "./install.js"
8
+ },
9
+ "scripts": {
10
+ "postinstall": "node install.js"
11
+ },
12
+ "files": [
13
+ "skills/",
14
+ "install.js",
15
+ "README.md",
16
+ "LICENSE"
17
+ ],
18
+ "keywords": [
19
+ "claude-code",
20
+ "claude",
21
+ "skills",
22
+ "accounting",
23
+ "tax",
24
+ "audit",
25
+ "cpa",
26
+ "bookkeeping"
27
+ ],
28
+ "author": "gonzih",
29
+ "license": "MIT",
30
+ "engines": {
31
+ "node": ">=18"
32
+ }
33
+ }
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: audit-finding-summary
3
+ description: Summarize an audit finding using the standard condition, criteria, cause, effect, and recommendation framework, plus a management response template.
4
+ triggers: ["summarize an audit finding", "audit finding summary", "write up an audit finding"]
5
+ ---
6
+
7
+ # Audit Finding Summary
8
+
9
+ ## What this skill does
10
+ Produces a structured audit finding write-up using the five-element framework standard in governmental and internal auditing: condition (what was found), criteria (what should be), cause (why it happened), effect (the risk or impact), and recommendation (what should change). Also generates a management response template for the auditee to complete. Output is suitable for inclusion in an audit report.
11
+
12
+ ## How to invoke
13
+ /audit-finding-summary [finding description]
14
+
15
+ ## Workflow steps
16
+
17
+ ### Step 1 — Understand the finding
18
+ Ask for or extract the key facts: what was observed, in which process or account, over what period, and with what frequency or dollar amount. If the user provides a rough description, identify any missing elements needed to complete the five-element write-up.
19
+
20
+ ### Step 2 — Draft the Condition
21
+ Write a factual, objective description of what the auditors observed. Use specific numbers, dates, and examples where available. Avoid judgment language — state facts only.
22
+
23
+ ### Step 3 — State the Criteria
24
+ Identify the standard, policy, regulation, contract, or best practice against which the condition is measured. Cite the source (e.g., "Per the organization's Procurement Policy, Section 4.2..." or "As required by 2 CFR Part 200...").
25
+
26
+ ### Step 4 — Identify the Cause
27
+ Explain the root cause of the condition — why the gap between the condition and the criteria exists. Distinguish between systemic causes (control design failures) and isolated causes (one-time errors).
28
+
29
+ ### Step 5 — Describe the Effect
30
+ Quantify and qualify the risk or impact: financial exposure, compliance risk, operational inefficiency, or reputational harm. Use specific dollar amounts or percentages where possible.
31
+
32
+ ### Step 6 — Write the Recommendation
33
+ Provide a clear, actionable recommendation addressed to management. Focus on correcting the root cause, not just the symptom. Number recommendations if there are multiple.
34
+
35
+ ### Step 7 — Generate the Management Response template
36
+ Produce a fillable template for management to: agree or disagree with the finding, describe their corrective action plan, assign a responsible party, and commit to a target completion date.
37
+
38
+ ## Example outputs
39
+ A structured finding write-up (Condition / Criteria / Cause / Effect / Recommendation) of approximately 300–500 words, followed by a management response block with labeled fields for management to complete.
@@ -0,0 +1,33 @@
1
+ ---
2
+ name: client-advisory-letter
3
+ description: Write a client advisory letter on a financial or tax topic with a plain-language explanation, implications for the client, and recommended actions.
4
+ triggers: ["write a client advisory letter", "client advisory letter", "draft an advisory letter for a client"]
5
+ ---
6
+
7
+ # Client Advisory Letter
8
+
9
+ ## What this skill does
10
+ Drafts a professional client advisory letter suitable for sending on firm letterhead. The letter explains a financial, tax, or regulatory development in plain language, describes how it affects the specific client, and closes with clear recommended actions and next steps. The tone is authoritative but accessible — no jargon without explanation.
11
+
12
+ ## How to invoke
13
+ /client-advisory-letter [topic or financial issue]
14
+
15
+ ## Workflow steps
16
+
17
+ ### Step 1 — Clarify the topic and client context
18
+ Identify the financial or tax topic to address. If not provided, ask for: the client's name (or placeholder), entity type, relevant background, and what the advisor wants the client to understand or do.
19
+
20
+ ### Step 2 — Write the opening and context
21
+ Open with a brief statement of purpose. Provide enough background on the topic (e.g., a law change, a market development, a planning opportunity) that the client understands why the letter is relevant to them.
22
+
23
+ ### Step 3 — Explain the implications for the client
24
+ Describe specifically how this topic affects the client's situation — taxes owed, cash flow, compliance obligations, risk exposure, or planning opportunities. Keep language concrete and avoid unnecessary hedging.
25
+
26
+ ### Step 4 — Recommend actions
27
+ List clear, prioritized actions the client should take. Include deadlines where applicable. Distinguish between actions the firm will handle and actions the client must take themselves.
28
+
29
+ ### Step 5 — Close professionally
30
+ Include a standard closing: an invitation to contact the firm with questions, a disclaimer that the letter is for informational purposes and does not constitute legal advice, and a signature block placeholder.
31
+
32
+ ## Example outputs
33
+ A 1–2 page letter addressed to a named client, structured as context → implications → recommended actions → close, suitable for email delivery or mailing on firm letterhead.
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: engagement-letter
3
+ description: Draft an engagement letter covering scope of services, fees, timing, client responsibilities, and standard terms.
4
+ triggers: ["draft an engagement letter", "write an engagement letter", "engagement letter"]
5
+ ---
6
+
7
+ # Engagement Letter
8
+
9
+ ## What this skill does
10
+ Drafts a professional engagement letter between an accounting or advisory firm and a client. Covers scope of services, fee structure, engagement timeline, client responsibilities, and standard terms (limitations of liability, dispute resolution, confidentiality). Output is suitable for review by counsel before use and can serve as the basis for a signed agreement.
11
+
12
+ ## How to invoke
13
+ /engagement-letter [service type and client details]
14
+
15
+ ## Workflow steps
16
+
17
+ ### Step 1 — Gather engagement details
18
+ If not provided, ask for: firm name, client name and entity type, services to be performed (e.g., tax return preparation, audit, bookkeeping, advisory), the engagement period, fee structure (fixed, hourly, retainer), and any known special terms or prior relationship context.
19
+
20
+ ### Step 2 — Draft the opening and parties section
21
+ Identify the parties, the date, and the purpose of the letter. State clearly that the letter constitutes the agreement between the firm and the client for the described services.
22
+
23
+ ### Step 3 — Define the scope of services
24
+ List the specific services the firm will provide. Be explicit about what is included and, where helpful, what is excluded. Avoid vague language like "assist with" — use specific deliverables and service descriptions.
25
+
26
+ ### Step 4 — State fees and billing terms
27
+ Describe the fee structure clearly: fixed fee, hourly rate, retainer amount, or blended arrangement. Include billing frequency, payment due dates, late payment terms, and handling of out-of-pocket expenses.
28
+
29
+ ### Step 5 — Outline timing and deliverables
30
+ State the expected timeline, key milestones, and delivery dates. Note dependencies on client-provided information.
31
+
32
+ ### Step 6 — State client responsibilities
33
+ List what the client must provide or do: timely delivery of records, access to personnel, approval of drafts, maintenance of underlying books and records. Clarify that the firm relies on client-provided information.
34
+
35
+ ### Step 7 — Include standard terms
36
+ Draft standard boilerplate: limitation of liability (cap on firm's liability), dispute resolution (mediation/arbitration clause), confidentiality, document retention, termination rights, and governing law. Flag that these terms should be reviewed by the firm's legal counsel before use.
37
+
38
+ ### Step 8 — Close with signature block
39
+ Include a signature block for both parties: authorized firm representative and client. Include a line for the client to acknowledge and return the letter.
40
+
41
+ ## Example outputs
42
+ A 2–4 page engagement letter in formal business letter format with clearly labeled sections, ready for the firm's attorney to review and adapt to their jurisdiction and professional standards.
@@ -0,0 +1,36 @@
1
+ ---
2
+ name: tax-memo
3
+ description: Write a structured tax research memo covering issue, facts, applicable law, analysis, conclusion, and a client-friendly summary.
4
+ triggers: ["write a tax memo", "tax research memo", "draft a tax memo"]
5
+ ---
6
+
7
+ # Tax Memo
8
+
9
+ ## What this skill does
10
+ Produces a formal tax research memo organized into standard sections: issue presented, relevant facts, applicable law (IRC sections, regulations, rulings, case law), legal analysis, conclusion, and a plain-language client summary. The memo follows the structure used by CPA firms and tax counsel for documentation and opinion support.
11
+
12
+ ## How to invoke
13
+ /tax-memo [topic or issue]
14
+
15
+ ## Workflow steps
16
+
17
+ ### Step 1 — Identify the issue
18
+ Clarify the specific tax question or questions to be addressed. If the user has not provided enough facts, ask for the client's situation, entity type, transaction details, and relevant dates.
19
+
20
+ ### Step 2 — Gather facts
21
+ Summarize the relevant facts as provided. Flag any missing information that would affect the analysis and note assumptions made.
22
+
23
+ ### Step 3 — Research applicable law
24
+ Identify and cite the governing authority: Internal Revenue Code sections, Treasury Regulations, Revenue Rulings, Revenue Procedures, IRS notices, and relevant Tax Court or Federal Circuit decisions. Note the weight of authority (primary vs. secondary).
25
+
26
+ ### Step 4 — Analyze the law against the facts
27
+ Apply the cited authorities to the specific facts. Address favorable and unfavorable authority. Identify planning opportunities or risk areas. Note any open questions or areas of uncertainty.
28
+
29
+ ### Step 5 — State the conclusion
30
+ Provide a clear conclusion for each issue with a confidence level (e.g., should, more likely than not, could). Recommend any protective actions such as disclosures or elections.
31
+
32
+ ### Step 6 — Write the client-friendly summary
33
+ Translate the conclusion into plain language the client can understand. Avoid jargon. State what it means for them and what (if anything) they need to do.
34
+
35
+ ## Example outputs
36
+ A memo with headed sections — Issue, Facts, Law, Analysis, Conclusion, Client Summary — suitable for inclusion in a client file, shared with counsel, or used to support a tax return position.