Guide · Agent skill
How to use the Geofeed Tuner agent skill (geofeed-tuner)
Updated · written with AI from the project's own documentation and checked against our catalogue data
Geofeed Tuner is an agent skill that helps a network operator build and clean up a geolocation feed, a public CSV file that states which city or country each block of publicly routable IP addresses is in. This guide explains what the skill makes the agent do, how to install it, how to trigger it with plain requests, and what it needs and touches on your machine. By the end you will be able to ask an agent to check a geofeed against RFC 8805 and receive an HTML report of the findings.
Geofeed Tunergithub/awesome-copilot · MIT Download the skill Quick start
- 1Download the ZIP. Download the geofeed-tuner skill ZIP from the page where you found this guide.
- 2Install the skill. Unzip it into ~/.claude/skills/ for a personal install or into .claude/skills/ in a project, or upload the ZIP under Settings → Capabilities → Skills in the Claude apps.
- 3Confirm Python 3 and Fastah access. Make sure Python 3 is available and that you have access to Fastah's MCP tool, since Phase 4 needs it and the tool is not in the skill files.
- 4Ask for a check in plain language. Describe the task, for example validating your geofeed CSV against RFC 8805, and attach the file or give its URL.
- 5Let the agent run the phases. The agent runs Phases 1 to 6 in order, writing scripts to run/ and saving any download to run/data/.
- 6Open the HTML report. Find the generated report in run/report/ and review each finding before you change or publish your feed.
What the geofeed-tuner skill does
An agent skill is a folder of instructions and reference files that an AI agent reads when a task matches the skill's description. This one covers self-published IP geolocation feeds, which are CSV files that let a network operator publish location data for its address space so geolocation providers can use it.
Once the skill is loaded, the agent works through six phases in order: understand the standard, gather the input feed, run structure and data quality checks, look up tuning suggestions through Fastah's MCP tool, generate an HTML tuning report, and do a final review of the report data. The agent checks the file against RFC 8805, which is included in the skill's references folder, and applies some recommendations that go beyond strict compliance.
- Checks that the CSV is well-formed and consistent
- Checks prefixes against RFC 8805 rules, such as host bits being set in a subnet and private or non-routable space
- Flags data quality problems
- Looks up tuning suggestions through Fastah's MCP tool
- Produces an HTML report summarising the findings
Install the geofeed-tuner skill
Download the skill ZIP from the page where you found this guide. Then choose one of the two installation routes below.
For a personal install, unzip the file into ~/.claude/skills/. To limit the skill to one project, unzip it into the .claude/skills/ folder inside that project. If you use the Claude apps, you can instead upload the ZIP under Settings → Capabilities → Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into .claude/skills/ inside your project
- Claude apps: upload the ZIP under Settings → Capabilities → Skills
Check what you need before you start
The skill needs Python 3 on the machine where the agent runs its scripts. Without Python 3 the workflow cannot run, because the agent writes and executes Python scripts to do the checks.
Phase 4 depends on Fastah's MCP tool for tuning data. That tool is not included in the skill files, so you need access to it for that phase. If you give the agent a feed at a remote URL, the agent also needs network access to download it.
- Python 3 installed
- Access to Fastah's MCP tool for the tuning data lookup (Phase 4)
- Network access if your input feed is fetched from a remote URL
Trigger the skill with a natural request
You do not need a special command. The skill's description tells the agent to use it when you mention IP geolocation feeds, RFC 8805, geofeeds, or when you want help creating, tuning, validating or publishing a CSV geolocation feed. Ask in plain language and name your file or describe your situation.
The skill is for publicly routable address space only. Ask it about private or internal address management and it will not apply.
- Validate my geofeed CSV against RFC 8805 and tell me what is wrong with it.
- Tune this geolocation feed before I submit it to geolocation providers.
- Check my IP location feed for data quality problems and produce a report.
- Help me publish a self-published IP geolocation feed for our ISP prefixes.
Understand the rules the agent follows
The skill sets rules on where files go. The reference and asset folders are read-only distribution files. Downloaded input goes to run/data/, HTML reports go to run/report/, and generated scripts go to run/. The agent runs scripts with the skill root as its working directory, so relative paths such as assets/iso3166-1.json resolve correctly.
The run/ folder may be cleared between sessions, so keep anything you need to keep outside the skill.
- Never write to assets/, references/ or scripts/
- Downloaded input files go to run/data/
- HTML reports go to run/report/
- Generated Python scripts go to run/
assets/ references/ scripts/ SKILL.mdKey RFC 8805 rules the skill enforces
A geofeed has up to five columns. Only the first, the IP prefix, is required. The skill's reference summary lists the columns in order and the rules that apply to each. The fifth column, postal code, is deprecated and must be left empty or absent, because postal codes are too fine-grained for IP ranges and raise privacy concerns.
An empty country code or the code ZZ is a do-not-geolocate signal for that prefix. Files must be UTF-8 and may contain comment lines starting with #.
- Column 1, ip_prefix: required, CIDR notation, IPv4 or IPv6
- Column 2, alpha2code: ISO 3166-1 alpha-2 country code; empty or ZZ means do not geolocate
- Column 3, region: ISO 3166-2 subdivision code such as US-CA
- Column 4, city: free text
- Column 5, postal_code: deprecated, leave empty
192.168.1.1/24 is invalid; use 192.168.1.0/24Tips for getting useful results
Give the agent the complete feed or a URL to it, and say which parts you care about most, such as accuracy, completeness or privacy. The skill's recommendations go beyond RFC compliance, so a feed can pass the standard and still get suggestions.
Read the HTML report yourself before you publish or submit anything. The skill is a checker and advisor, and the findings are only as good as the input and the tuning data.
- Keep the feed to publicly routable prefixes only
- Use the reference RFC text only for edge cases; the skill's summary covers most checks
- Review each suggestion in the report before applying it
What people use it for
- An ISP checks its geofeed for structural errors before submitting it to geolocation providers.
- A mobile carrier reviews its published prefixes for data quality problems and inconsistent country or region codes.
- A hosting company audits which prefixes are marked do-not-geolocate and confirms the entries are intended.
- A network team produces an HTML report of tuning suggestions to share with colleagues.
Frequently asked questions
How do I install the geofeed-tuner skill?
Download the skill ZIP and unzip it into ~/.claude/skills/ for a personal install, or into .claude/skills/ inside a project. In the Claude apps you can upload the ZIP under Settings → Capabilities → Skills instead.
What does the geofeed-tuner skill require?
It requires Python 3, because the agent runs Python scripts for the checks. Phase 4 needs access to Fastah's MCP tool, which is not included in the files, and a remote input URL needs network access.
Is the geofeed-tuner skill free and what is its licence?
The listing records the licence as MIT, but the SKILL.md frontmatter says Apache-2.0. Check the licence file in the repository before you rely on either.
Can I use geofeed-tuner for private or internal IP addresses?
No. The skill applies only to publicly routable IP addresses and says not to use it for private or internal IP address management.
Does the skill run code on my machine and connect to the internet?
Yes. The agent writes and runs Python scripts, and it uses the network to download remote feeds and to query Fastah's MCP tool for tuning data. It keeps downloads and reports in run/ and does not write to assets/, references/ or scripts/.
What are alternatives to geofeed-tuner for checking a geofeed?
This guide does not compare other tools, so it cannot say how they rank. You can validate a feed manually against RFC 8805, whose text is included in the skill's references folder.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Geofeed Tuner suits network engineers at ISPs, mobile carriers, cloud or hosting companies, and IXPs who publish a self-published geofeed and want it checked against RFC 8805 before submission. Skip it if you manage private addresses, need general web or design help, or cannot run Python 3 and reach Fastah's tool.
Download the skill