fukugyo-invoice

Generate monthly invoices from timecard.json and register them to freee or output Markdown.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/rgbkids/fukugyo --skill fukugyo-invoice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fukugyo-invoice
Source: https://github.com/rgbkids/fukugyo/tree/main/skills/invoice
Command: npx skills add https://github.com/rgbkids/fukugyo --skill fukugyo-invoice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

副業・個人事業主の月次請求作業を自動化して、手作業の煩雑さを削減します。

Core Features & Use Cases

  • Timecardデータを元に請求書を自動作成: timecard.json のデータを基に月分の請求書を自動生成します。
  • freee MCP 接続時の直接登録と未接続時のMarkdown出力: freee MCP が接続されていれば直接登録、未接続の場合はMarkdownファイルとして出力します。
  • 複数クライアント対応と適格請求書対応: 複数クライアントへ一括発行可能で、適格請求書に対応します。

Quick Start

請求書を作成したい月を指定して請求書を生成します、月は 2026-03 の形式で指定してください。

Frequently Asked Questions about fukugyo-invoice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate monthly invoice generation from timecard data?

You can automate monthly invoicing by feeding timecard.json data into the workflow, which generates invoices and either registers them to freee via MCP or outputs them as Markdown files.

Can I issue invoices to multiple clients at once as a freelancer?

Yes, multi-client invoicing is supported, allowing freelancers and small teams to batch-generate invoices for multiple clients from a single timecard.json dataset.

Does the invoicing workflow support freee MCP integration for direct registration?

Yes, when the freee MCP connection is detected, invoices are registered directly in freee; if not connected, it falls back to generating Markdown invoice files instead.

How do I create compliant invoices for side-hustle income?

Compliant invoices for side-hustle income are created by generating qualified invoices, either registered to freee or output as Markdown, with monthly timecard data as the source.

What happens to invoice automation if the freee MCP connection is unavailable?

If the freee MCP connection is unavailable, the automation falls back to generating Markdown invoice files locally and updates the invoices.json ledger to track all records.

Do I need a specific timecard format to automate side-hustle billing?

You need a structured timecard.json file containing your monthly work data and a specified target month in YYYY-MM format to trigger the automated side-hustle invoice generation.