@yukioa2z/visa-apply 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yukioa2z
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# Visa Apply Skill
+
+Research, prepare, review, and track visa applications with current official sources and a local HTML dossier as the single source of truth.
+
+[Website](https://yukioa2z.github.io/visa-apply/) · [Source](https://github.com/Yukioa2z/visa-apply)
+
+```sh
+npx --yes @yukioa2z/visa-apply
+```
+
+Then invoke. To just check whether you need a visa:
+
+```text
+Use $visa-apply: I hold an X passport, live in Y, and want to visit Z for two weeks — do I need a visa?
+```
+
+Many trips end there with a visa-free or ETA answer. To prepare a full application:
+
+```text
+Use $visa-apply to help me prepare a visa application for my destination and visa type.
+```
+
+The installer copies the skill to `~/.codex/skills/visa-apply`. For Claude Code, Hermes, OpenClaw, or another agent with a different skill directory:
+
+```sh
+npx --yes @yukioa2z/visa-apply -- --dest ~/.claude/skills
+```
+
+## Pipeline
+
+1. Resolve destination, passport/status, residence, application location, purpose, dates, arrival mode, and every transit.
+2. Perform a fresh official-source check for visa-free, ETA, eVisa, visa on arrival, consular visa, transit authorization, or residence route.
+3. Build a country and visa-type question path.
+4. Collect raw answers and normalized final values into the HTML dossier.
+5. Build and review the document checklist.
+6. Assist with portal entry after applicant review.
+7. Backfill application IDs, fees, appointments/biometrics, decision, and passport return status.
+
+## Coverage
+
+The searchable directory contains 250 ISO countries/areas, including the commonly used XK code for Kosovo. Cached official starting sources cover 40 destinations plus the Schengen route area; every other destination triggers live official-source discovery. Full country adapters (rules and document checklist verified against official sources) exist for the United States (DS-160), Schengen (Type C), Canada (IRCC), the United Kingdom, Australia, and Japan; every other destination uses a source-seeded or live-discovered adapter.
+
+No cached source stores a visa-free or visa-required answer. Every case must be checked against current destination-government rules for the exact travel document, residence, purpose, date, duration, arrival mode, and transit itinerary. IATA Travel Centre/Timatic or the operating carrier is used as a boarding-document cross-check, not as legal authority.
+
+Government immigration, foreign-ministry, and embassy pages are the rule authority. Delegated visa application centres are used only for appointment and submission logistics.
+
+The applicant model is global. It keeps citizenship, travel-document issuer, legal residence, current location, consular application location, and transit route separate, including dual nationals, third-country applicants, minors, and holders of refugee or other non-passport travel documents.
+
+This skill is not legal advice. The applicant must review all information and handle applicant-only declarations, signatures, certifications, CAPTCHA, and submission.

package/bin/install.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const skillName = "visa-apply";
+const packageRoot = path.resolve(__dirname, "..");
+const sourceDir = path.join(packageRoot, "skill");
+
+function usage() {
+  console.log(`Install ${skillName}
+
+Usage:
+  npx @yukioa2z/visa-apply
+  npx @yukioa2z/visa-apply -- --dest ~/.claude/skills
+
+Options:
+  --dest <path>   Skill root directory. Defaults to $CODEX_HOME/skills or ~/.codex/skills.
+  --dry-run       Print the destination without copying files.
+  --help          Show this help message.
+`);
+}
+
+function expandHome(value) {
+  if (!value) return value;
+  if (value === "~") return os.homedir();
+  if (value.startsWith("~/")) return path.join(os.homedir(), value.slice(2));
+  return value;
+}
+
+function readOption(name) {
+  const args = process.argv.slice(2);
+  const index = args.indexOf(name);
+  if (index === -1) return undefined;
+  return args[index + 1];
+}
+
+const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+  usage();
+  process.exit(0);
+}
+
+if (!fs.existsSync(sourceDir)) {
+  console.error(`Skill source not found: ${sourceDir}`);
+  process.exit(1);
+}
+
+const defaultRoot = process.env.CODEX_HOME
+  ? path.join(process.env.CODEX_HOME, "skills")
+  : path.join(os.homedir(), ".codex", "skills");
+
+const destRoot = path.resolve(expandHome(readOption("--dest") || defaultRoot));
+const destDir = path.join(destRoot, skillName);
+
+if (args.includes("--dry-run")) {
+  console.log(destDir);
+  process.exit(0);
+}
+
+fs.mkdirSync(destRoot, { recursive: true });
+fs.rmSync(destDir, { recursive: true, force: true });
+fs.cpSync(sourceDir, destDir, { recursive: true });
+
+console.log(`Installed ${skillName} to ${destDir}`);
+console.log(`Try: Use $${skillName} to check your visa need and prepare an application dossier.`);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@yukioa2z/visa-apply",
+  "version": "3.0.0",
+  "description": "Install a global visa-need research and application filing skill.",
+  "license": "MIT",
+  "keywords": [
+    "visa",
+    "immigration",
+    "agent",
+    "skill",
+    "claude-code",
+    "codex",
+    "ds-160"
+  ],
+  "homepage": "https://yukioa2z.github.io/visa-apply/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Yukioa2z/visa-apply.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Yukioa2z/visa-apply/issues"
+  },
+  "bin": {
+    "visa-apply": "./bin/install.js"
+  },
+  "files": [
+    "bin",
+    "skill",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: visa-apply
+description: Use when checking whether a traveler needs a visa, ETA, eVisa, visa on arrival, or transit authorization, or when researching, preparing, reviewing, tracking, or filling an entry application for any destination. Supports a 250-destination directory, mandatory current official-source verification for the exact passport/residence/itinerary, country and visa-type branching, a local HTML dossier as the single source of truth, and assisted browser/computer form entry after applicant review.
+---
+
+# Visa Apply
+
+## Purpose
+
+Create and maintain a local HTML dossier as the single source of truth for a visa application. Resolve the correct country and visa route from current official sources, collect applicant facts with a country/visa-specific question path, prepare a final form preview and document checklist, then assist with portal entry after applicant review.
+
+The most common entry point is a lightweight question — "I hold an X passport, live in Y, want to visit Z for two weeks: do I need a visa?" Answer that first by running the live route check (step 3). Many trips end there with a visa-free or ETA verdict and never need a full application; only continue to detailed intake when a visa is actually required.
+
+This skill is not legal advice. The applicant must review every answer and handle any applicant-only declaration, signature, certification, CAPTCHA, and submission.
+
+## Required Workflow
+
+1. Keep all applicant data local. Personal data collected for the application lives only in the local HTML dossier on the user's machine. Never transmit it to any external service, log it outside the dossier, or use it for any purpose other than this application. This is a hard constraint, not a user setting.
+2. Collect routing facts only: destination, all nationalities or stateless/refugee status, travel-document type and issuing country, legal residence and residence status, actual application location, purpose, dates/duration, and relevant existing visas or residence permits.
+   - First, ask whether the trip is a single destination or involves multiple countries or transit. Most applicants are single-destination; assume that unless the user says otherwise. If multiple countries or transit are involved, treat each leg as its own route and run the live check (step 3) separately per leg; a `mixed` verdict means the legs resolve to different routes.
+   - Never infer nationality, residence, consular jurisdiction, or form language from the user's location or preferred language.
+   - Treat citizenship, legal residence, current physical location, and application location as separate facts.
+3. Run the mandatory live visa-need check before detailed intake.
+   - Read `references/live-route-check.md`.
+   - Resolve the destination in `references/jurisdictions.json`; cached starting sources are in `references/official-sources.json`.
+   - Run `python3 scripts/source_registry.py live-check-plan <country> ...` when useful.
+   - Browse current destination-government and responsible-mission sources for the exact passport, residence, purpose, dates, duration, entries, arrival mode, and transit itinerary.
+   - Cross-check IATA Travel Centre/Timatic or the operating carrier for boarding requirements. Treat it as operational evidence, not legal authority.
+   - Never reuse a static visa-free, ETA, eVisa, visa-on-arrival, or visa-required verdict.
+   - If live browsing is unavailable, leave the verdict unresolved and stop; do not substitute model memory.
+4. Stop at the route gate. Record the verdict, conditions, effective dates, transit result, sources, checked timestamp, conflicts, and recheck deadline in the HTML. If unresolved, keep it unresolved and name the next verification action.
+5. Build the question path.
+   - Load `references/core-intake.md`.
+   - Load the matching full adapter from `references/countries/` when available.
+   - For a source-seeded or unsupported destination, use `references/adapter-schema.md` to create a temporary adapter from official sources before detailed intake.
+6. Use the `grill-me` interview pattern. If available, read `/Users/yuuue/.agents/skills/grill-me/SKILL.md`. Ask one question at a time by default and provide a recommended answer format. Use compact, numbered batches only when the user asks for fewer turns.
+7. Update the HTML after every answer batch and milestone.
+   - Raw answers and provenance go under `Source: Collected Answers`.
+   - Normalized final values go under `Final Visa Application Preview`.
+   - Required evidence goes under `Document Checklist`.
+   - Uncertainty stays visible under `Open Issues`.
+   - No chat note or scratch file may become more authoritative than the HTML.
+8. Run `references/quality-gates.md`, then stop at the applicant review gate before portal entry. Call out inferred values, stale sources, missing documents, expiring evidence, and unresolved conflicts.
+9. Assist with form entry using Browser or Computer Use after review.
+   - In non-Codex environments, use the equivalent browser/computer capability, such as Peekaboo or the runtime's supported automation skill.
+   - Never bypass CAPTCHA or security controls, invent data, or perform an applicant-only signature/certification.
+10. Backfill application IDs, receipts, appointments/biometrics, document requests, decision status, and passport/visa return details into the HTML.
+
+## Dossier Creation
+
+Create a dossier from `assets/visa-dossier-template.html` with:
+
+```sh
+python3 scripts/create_dossier.py /path/to/visa-dossier.html \
+  --country ca \
+  --visa-type "Visitor visa" \
+  --form-name "IRCC Portal application" \
+  --application-location "Japan, Tokyo" \
+  --nationality "Brazil" \
+  --travel-document-issuer "Brazil" \
+  --legal-residence "Japan" \
+  --residence-status "Work permit holder" \
+  --purpose "Tourism" \
+  --arrival-date "2026-10-01" \
+  --duration "14 days" \
+  --entries "Single" \
+  --arrival-mode "Air" \
+  --transit "Singapore, airside"
+```
+
+## References
+
+- Full pipeline and source freshness rules: `references/pipeline.md`
+- Universal intake sections: `references/core-intake.md`
+- Country adapter format: `references/adapter-schema.md`
+- Mandatory live visa-need check: `references/live-route-check.md`
+- Submission, document, timing, and privacy gates: `references/quality-gates.md`
+- Searchable destination directory: `references/jurisdictions.json`
+- Official source registry: `references/official-sources.json`
+- Full country adapters: `references/countries/` — United States DS-160 (`us.md`), Schengen Type C (`schengen.md`), Canada IRCC (`ca.md`), United Kingdom (`uk.md`), Australia (`au.md`), Japan (`jp.md`). Every other destination uses a source-seeded or live-discovered adapter.

package/skill/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Visa Apply"
+  short_description: "Check visa need, prepare, and track applications."
+  default_prompt: "Use $visa-apply to check my current entry route and prepare a local visa application dossier if needed."
+
+policy:
+  allow_implicit_invocation: true