← Back to Skills Marketplace
anthonymq

IDFM Journey

by anthonymq · GitHub ↗ · v0.1.6 · MIT-0
cross-platform ⚠ suspicious
2152
Downloads
0
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install idfm-journey-skill
Description
Query Île-de-France Mobilités (IDFM) PRIM/Navitia for Paris + suburbs public transport (Île-de-France) — place resolution, journey planning, and disruptions/...
README (SKILL.md)

IDFM Journey (PRIM/Navitia)

Use the bundled script to call PRIM/Navitia endpoints without extra dependencies.

Metadata

  • Author: anthonymq
  • Version: 0.1.6

Trigger phrases (examples)

  • "Itinéraire de {origine} à {destination}"
  • "Route from {origin} to {destination} in Paris / Île-de-France"
  • "Check RER/metro disruptions" / "incidents on line {line}"

Prereqs

  • Set IDFM_PRIM_API_KEY in the environment before running.

Generating an API Key

To obtain an IDFM PRIM API key:

  1. Visit https://prim.iledefrance-mobilites.fr/
  2. Create an account or log in
  3. Navigate to "Espace développeur" or the developer portal
  4. Subscribe to the "Navitia" API
  5. Your API key will be generated and displayed in your dashboard
  6. Export it in your environment: export IDFM_PRIM_API_KEY="your-key-here"

Quick commands

Run from anywhere (path is inside the skill folder):

  • Resolve places (best match + list):

    • python3 scripts/idfm.py places "Ivry-sur-Seine" --count 5

  • Journeys (free-text from/to; resolves place ids first):

    • python3 scripts/idfm.py journeys --from "Ivry-sur-Seine" --to "Boulainvilliers" --count 3

  • Incidents / disruptions (by line id or filter):

    • python3 scripts/idfm.py incidents --line-id line:IDFM:C01727
    • python3 scripts/idfm.py incidents --filter 'disruption.status=active'

Add --json to print raw API output.

Notes

  • If place resolution is ambiguous, increase --count and choose the right stop_area id.
  • For API details and examples, read: references/idfm-prim.md.
Usage Guidance
This skill appears to be a straightforward Python wrapper for the IDFM PRIM/Navitia API and only needs your IDFM_PRIM_API_KEY. Before installing: (1) note the registry metadata omits the required env var — double-check you set IDFM_PRIM_API_KEY only for this skill; (2) review the included scripts/idfm.py yourself (it only uses urllib and calls the official prim.iledefrance-mobilites.fr endpoint); (3) avoid pasting other unrelated secrets into the environment; (4) run it in an isolated environment if you are unsure (or ask the publisher to update the registry metadata to declare the required env var). If you need higher assurance, ask the owner to provide a verified homepage or more provenance for the package.
Capability Analysis
Type: OpenClaw Skill Name: idfm-journey-skill Version: 0.1.6 The skill is a legitimate tool for querying the Île-de-France Mobilités (IDFM) transport API. The Python script (scripts/idfm.py) uses the standard library (urllib) to interact with official endpoints and correctly handles the API key via environment variables. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
ℹ Purpose & Capability
The skill's name/description (IDFM PRIM/Navitia queries) matches the bundled script and documentation: place resolution, journeys, and disruptions. However, the registry metadata lists no required environment variables while SKILL.md and scripts/idfm.py both require IDFM_PRIM_API_KEY — an inconsistency between declared metadata and actual runtime needs.
✓ Instruction Scope
SKILL.md instructs the agent/user to set IDFM_PRIM_API_KEY and run the included Python script. The runtime instructions are narrow: call the public Navitia endpoints, optionally print JSON, and pick place IDs. The instructions do not ask to read unrelated local files, transmit data to unknown endpoints, or collect extra system context.
✓ Install Mechanism
No install spec or external downloads; the skill is instruction-only with a bundled Python script that uses only the standard library (urllib). Nothing is written to disk beyond the packaged files. This is a low-risk install mechanism.
⚠ Credentials
The script legitimately needs a single service credential (IDFM_PRIM_API_KEY) to call the Navitia API, which is proportional to purpose. The concern is the metadata/registry omission: the top-level metadata claims no required env vars while the SKILL.md and script require an API key. That mismatch could lead to accidental exposure (users won't be warned by the registry) or confusion about what to provide.
✓ Persistence & Privilege
The skill does not request persistent/always-included presence. It does not modify other skills or system settings. Autonomous invocation is allowed (default) but not combined with other elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install idfm-journey-skill
  3. After installation, invoke the skill by name or use /idfm-journey-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.6
Add LICENSE + complete SKILL.md frontmatter fields (author/triggers/version)
v0.1.5
Declare required env IDFM_PRIM_API_KEY + add base-url exfiltration warning
v0.1.4
republish: try different tag
v0.1.3
republish for registry visibility
v0.1.2
Retry publish (registry visibility)
v0.1.1
Fix publish bundle; improve journeys output formatting
v0.1.0
- Initial release of idfm-journey-skill for Île-de-France Mobilités (IDFM) journey planning and incident checks. - Supports place resolution, journey planning, and retrieving disruptions/incidents via the PRIM/Navitia API. - Provides command-line scripts for querying places, planning journeys, and checking incidents. - Requires setting the `IDFM_PRIM_API_KEY` environment variable before use.
Metadata
Slug idfm-journey-skill
Version 0.1.6
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 7
Frequently Asked Questions

What is IDFM Journey?

Query Île-de-France Mobilités (IDFM) PRIM/Navitia for Paris + suburbs public transport (Île-de-France) — place resolution, journey planning, and disruptions/... It is an AI Agent Skill for Claude Code / OpenClaw, with 2152 downloads so far.

How do I install IDFM Journey?

Run "/install idfm-journey-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is IDFM Journey free?

Yes, IDFM Journey is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does IDFM Journey support?

IDFM Journey is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created IDFM Journey?

It is built and maintained by anthonymq (@anthonymq); the current version is v0.1.6.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments