Agent skill

xlsx-jp

Generate Japanese Excel files (.xlsx) using openpyxl with Japanese fonts, currency formatting (¥), Japanese era calendar (和暦), tax calculation, and business templates. Triggers on requests to create Excel帳票, 見積書Excel, 請求書xlsx, 勤怠管理表, 日本語スプレッドシート.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/xlsx-jp

SKILL.md

日本語 Excel ファイル生成スキル

概要

openpyxl を使用して、日本語のビジネス帳票を正しいフォーマットで .xlsx ファイルとして生成するスキルです。通貨表示（¥）、和暦、消費税計算、印鑑欄など、日本のビジネス帳票に必要な要素をカバーします。

前提条件

bash
pip install openpyxl

基本設定

ワークブック作成と日本語フォント

python
from openpyxl import Workbook
from openpyxl.styles import Font, Alignment, Border, Side, PatternFill, numbers
from openpyxl.utils import get_column_letter

wb = Workbook()
ws = wb.active

# デフォルトフォント設定
default_font = Font(name='游ゴシック', size=10)
ws.sheet_properties.defaultRowHeight = 18

推奨フォント一覧

用途 フォント名 特徴
帳票全般 游ゴシック（Yu Gothic） 視認性が高く帳票向き
フォーマルな文書 游明朝（Yu Mincho） 正式な印象
互換性重視 MS ゴシック（MS Gothic） 等幅、古い環境でも表示可
互換性重視 MS 明朝（MS Mincho） 等幅明朝体

フォントサイズの基準

要素 サイズ
帳票タイトル 18pt〜24pt
セクション見出し 12pt〜14pt
データセル 10pt〜11pt
注釈・備考 9pt

通貨フォーマット（¥）

日本円の表示形式を設定します：

python
from openpyxl.styles.numbers import FORMAT_NUMBER_COMMA_SEPARATED1

# 方法1: ¥記号付き桁区切り
yen_format = '¥#,##0'

# 方法2: マイナス値の表示（赤字）
yen_format_with_negative = '¥#,##0;[Red]-¥#,##0'

# 方法3: 税込・税抜表示用
yen_format_tax_included = '¥#,##0"(税込)"'

# 適用例
cell = ws['E5']
cell.value = 1500000
cell.number_format = yen_format

数値フォーマット一覧

フォーマット 表示例 用途
¥#,##0 ¥1,500,000 基本的な金額表示
¥#,##0;[Red]-¥#,##0 -¥500 （赤字） 赤字表示付き
#,##0 1,500,000 金額（¥なし）
0.0% 10.0% 税率表示
#,##0.0"時間" 160.0時間 労働時間

和暦（日本の年号）対応

python
from datetime import date

def to_wareki(d):
    """西暦から和暦に変換する"""
    wareki_eras = [
        (date(2019, 5, 1), '令和'),
        (date(1989, 1, 8), '平成'),
        (date(1926, 12, 25), '昭和'),
        (date(1912, 7, 30), '大正'),
    ]
    for start_date, era_name in wareki_eras:
        if d >= start_date:
            year = d.year - start_date.year + 1
            year_str = '元' if year == 1 else str(year)
            return f'{era_name}{year_str}年{d.month}月{d.day}日'
    return f'{d.year}年{d.month}月{d.day}日'

# 使用例
today = date.today()
ws['B3'] = to_wareki(today)  # 例: 令和8年3月4日

Excel セルでの和暦表示

python
from openpyxl.styles import numbers

cell = ws['B3']
cell.value = date(2026, 3, 4)
cell.number_format = '[$-ja-JP-x-gannen]ggge"年"m"月"d"日"'
# 表示: 令和8年3月4日

消費税計算

標準税率（10%）と軽減税率（8%）

python
TAX_RATE_STANDARD = 0.10   # 標準税率 10%
TAX_RATE_REDUCED = 0.08    # 軽減税率 8%（食品・新聞等）

def calculate_tax(amount, rate=TAX_RATE_STANDARD):
    """消費税を計算する（端数切り捨て）"""
    import math
    return math.floor(amount * rate)

# Excel数式での計算
ws['F10'] = '=FLOOR(F9*0.1, 1)'   # 標準税率（10%）
ws['F11'] = '=FLOOR(F9*0.08, 1)'  # 軽減税率（8%）
ws['F12'] = '=F9+F10'              # 合計（10%対象）

インボイス制度対応

適格請求書（インボイス）に必要な項目：

項目 内容
登録番号 T + 13桁の数字（例: T1234567890123）
税率ごとの区分 10%対象 / 8%対象（軽減税率）を分けて記載
税率ごとの消費税額 それぞれの税率に対する消費税額を明記

印鑑欄の作成

python
def add_inkan_area(ws, start_row, start_col, labels=None):
    """印鑑欄を作成する"""
    if labels is None:
        labels = ['承認', '確認', '担当']

    thin_border = Border(
        left=Side(style='thin'),
        right=Side(style='thin'),
        top=Side(style='thin'),
        bottom=Side(style='thin'),
    )
    center_align = Alignment(horizontal='center', vertical='center')

    for i, label in enumerate(labels):
        col = start_col + i
        # ラベルセル
        cell = ws.cell(row=start_row, column=col, value=label)
        cell.font = Font(name='游ゴシック', size=8)
        cell.alignment = center_align
        cell.border = thin_border

        # 印鑑スペース（下の行を結合して高さを確保）
        stamp_cell = ws.cell(row=start_row + 1, column=col)
        stamp_cell.border = thin_border
        stamp_cell.alignment = center_align

    # 印鑑スペースの行の高さを設定
    ws.row_dimensions[start_row + 1].height = 60

セルスタイルのユーティリティ

ヘッダー行のスタイル

python
header_font = Font(name='游ゴシック', size=10, bold=True, color='FFFFFF')
header_fill = PatternFill(start_color='4472C4', end_color='4472C4', fill_type='solid')
header_align = Alignment(horizontal='center', vertical='center', wrap_text=True)
header_border = Border(
    left=Side(style='thin'),
    right=Side(style='thin'),
    top=Side(style='thin'),
    bottom=Side(style='thin'),
)

def apply_header_style(ws, row, start_col, end_col):
    """ヘッダー行にスタイルを適用する"""
    for col in range(start_col, end_col + 1):
        cell = ws.cell(row=row, column=col)
        cell.font = header_font
        cell.fill = header_fill
        cell.alignment = header_align
        cell.border = header_border

罫線パターン

python
# 細い実線（帳票データ行）
thin_border = Border(
    left=Side(style='thin'),
    right=Side(style='thin'),
    top=Side(style='thin'),
    bottom=Side(style='thin'),
)

# 太い外枠線（合計行など）
thick_bottom = Border(
    left=Side(style='thin'),
    right=Side(style='thin'),
    top=Side(style='thin'),
    bottom=Side(style='thick'),
)

# 二重線（最終合計行の下）
double_bottom = Border(
    bottom=Side(style='double'),
)

ビジネステンプレート

見積書

日本のビジネスで使用する標準的な見積書を Excel で作成します。

  • 参照: templates/mitsumori.md

勤怠管理表

月次の勤怠管理表（出退勤、休憩、残業時間を管理）を作成します。

  • 参照: templates/kintai.md

印刷設定

python
from openpyxl.worksheet.page import PageMargins

# 用紙サイズ（A4）
ws.page_setup.paperSize = ws.PAPERSIZE_A4

# 印刷方向（縦）
ws.page_setup.orientation = 'portrait'

# 余白設定（インチ単位）
ws.page_margins = PageMargins(
    left=0.75, right=0.75,
    top=1.0, bottom=1.0,
    header=0.5, footer=0.5,
)

# 1ページに収める
ws.page_setup.fitToWidth = 1
ws.page_setup.fitToHeight = 1
ws.sheet_properties.pageSetUpPr.fitToPage = True

# ヘッダー・フッター
ws.oddHeader.center.text = '【会社名】'
ws.oddFooter.center.text = 'Page &P of &N'

生成時の確認事項

帳票を生成する前に、以下をユーザーに確認してください：

  1. 帳票の種類: 見積書 / 請求書 / 勤怠管理表 / その他
  2. フォント: 游ゴシック（デフォルト）/ 游明朝 / MS ゴシック
  3. 日付形式: 和暦（デフォルト）/ 西暦
  4. 消費税率: 10%（デフォルト）/ 8%（軽減税率）/ 混合
  5. 印鑑欄: 必要（承認・確認・担当）/ 不要 / カスタム
  6. 印刷設定: A4 縦（デフォルト）/ A4 横 / B4 / A3
  7. シート名: 日本語で指定（例: 「見積書」「勤怠管理」）

不明な項目はデフォルト値を使用し、プレースホルダーには 【〇〇】 を使用してください。

出力時の注意事項

  • ファイル名は英数字を推奨: mitsumori_20260304.xlsx
  • シート名は日本語可: ws.title = '見積書'
  • 列幅は内容に応じて適切に調整する
  • 数式を使用する場合、保存後に Excel で再計算が必要な場合がある
  • wb.save('filename.xlsx') で保存する

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results