smithery.ai

fuel-bill-processor

Process aviation fuel surcharge bills from Excel files.

First seen May 2, 2026

Installation

$ npx skills add https://smithery.ai

Summary

  • Process aviation fuel surcharge bills from Excel files.
  • Supports both automatic detection and Claude-assisted modes.
  • Detects headers, matches columns, parses dates/routes, and fetches contract numbers via API.
  • Use when working with aviation fuel bills, Excel file processing, or when user mentions fuel surcharges,航空燃油账单, or 燃油差价费.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,203 B
  • docs SUMMARY.md 380 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Fuel Bill Processor

Process aviation fuel surcharge bills from Excel files with automatic format detection or Claude-assisted mode.

Processing Workflow

Step 1: Try Automatic Mode First

Always try automatic mode first:

python3 scripts/process.py input_file.xls [-o output.xlsx]

Step 2: Claude-Assisted Mode (Only if Step 1 Fails)

Use when auto mode fails (header beyond row 15, non-standard columns, complex structure).

  1. Analyze structure:

``bash python3 scripts/analyze.py input_file.xls ``

  1. Execute suggested command:

``bash python3 scripts/process.py input_file.xls \ --header-row 2 --date-column B --route-column C \ --flight-column D --price-column E ``

Parameters: --header-row (0-based), --date-column, --route-column, --flight-column, --price-column (column letters like A/B/C or column names).

Step 3: Verify Results

Confirm output file created with expected rows and populated fields.

Configuration

Uses assets/config.json (ready out of the box). See [CONFIGURATION.md](references/CONFIGURATION.md) for details.

Troubleshooting

Symptom Solution
"Column not recognized" warning Add column name to column_mappings in [config.json](assets/config.json)
"Date parsing failed" errors Add format to date_formats array in config
API timeout or empty response Check API URL in config, test network connectivity
Output file has fewer rows than expected Input may have invalid/summary rows being filtered

For complex table issues, run analyze.py to diagnose structure.

References

  • [APIREFERENCE.md](references/APIREFERENCE.md) - Detailed API documentation
  • [CONFIGURATION.md](references/CONFIGURATION.md) - Complete configuration guide