fukugyo

Automates freelance administrative workflows for time tracking, invoicing, payment monitoring, and legal escalation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdfminer.six, backports.zoneinfo, and includes scripts (resource) components.

What problem does it solve?

Freelancers and side-job workers spend too much time on repetitive administrative tasks—tracking daily hours, creating compliant invoices, checking payments, and preparing legal follow-ups—which distracts from billable work and increases risk of missed payments.

Core Features & Use Cases

  • Time tracking: Combine Slack check-in/out posts with Chrome browsing history to reconstruct daily work sessions and summarize monthly hours per client.
  • Contract analysis: Read PDF/txt/md contracts and extract hourly rates, payment terms, IP clauses, NDA and other risk items for automated configuration.
  • Invoicing & payments: Generate monthly invoices (Markdown or freee integration), compute tax and due dates, monitor payment status, and produce staged reminder emails.
  • Escalation support: Create content for formal demand letters, 支払督促 forms, and small-claims drafts with cost estimates and filing guidance.
  • Use Case: A solo contractor uses Slack for check-ins, runs the timecard flow to produce a monthly invoice, then runs payment checks and triggers escalation documents if a client remains unpaid.

Quick Start

Run the interactive setup and then enter the root command /fukugyo to register your personal info, add clients, and begin daily timecard and invoice workflows.

Frequently Asked Questions about fukugyo

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

FAQPage Schema
How do I automate freelance invoice generation from Slack time tracking?

Automate freelance invoice generation by collecting daily work logs from Slack check-in posts and Chrome browsing history, then summarizing monthly hours per client to generate Markdown invoices or sync with freee. The workflow reconstructs work sessions automatically, computes taxes and due dates, and outputs ready-to-send invoices.

Can I extract hourly rates and payment terms from PDF contracts automatically?

Yes, you can extract hourly rates and payment terms from PDF contracts automatically using pdfminer.six. The contract analysis feature reads PDF, txt, and md files to parse payment terms, hourly rates, IP clauses, and NDA risk items for automated workflow configuration.

What is the best way to send staged payment reminders to freelance clients?

The best way to send staged payment reminders is to monitor payment status automatically and trigger escalating reminder emails when invoices become overdue. The system checks payment dates against computed due dates and produces staged reminder emails that escalate in tone as delinquency continues.

How do I prepare legal escalation documents for unpaid freelance invoices?

Prepare legal escalation documents by generating formal demand letters, 支払督促 forms, and small-claims drafts with cost estimates and filing guidance. The escalation support feature creates structured content for legal follow-up when clients remain unpaid after staged reminders.

Does this freelance invoicing workflow integrate with freee for accounting?

Yes, the freelance invoicing workflow integrates with freee via optional freee MCP integration to generate invoices directly within the accounting platform. You can also produce standalone Markdown invoices if you prefer manual accounting entry.

Do I need Slack MCP integration to track freelance hours with this tool?

No, you do not need Slack MCP integration to track freelance hours, though it is supported as an optional integration. The tool can reconstruct daily work sessions using Chrome browsing history alone, but combining both Slack check-in posts and browser history provides more accurate time tracking.