Preferences management

Skill hec-ovi/agentickit/examples/travel/.pilot/skills/preferences-management

AI copilot for React apps. Reads your state, fills forms, confirms actions, calls your tools. Multi-agent, AI SDK 6 + AG-UI, markdown skills. MIT.

Install

npx -y skills add hec-ovi/agentickit --skill preferences-management

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Edit long-term user preferences: home airport, preferred currency, default trip duration, etc. Persisted across trips. Mutating; framework fires the confirm modal before any change.

SKILL.md

2.3 KB, as published. Nobody here has run it

Page scope

update_preferences is auto-registered on the Preferences page (URL /preferences) by usePilotState({ name: "preferences", setValue }). On every other page it is not in the registry and a call will silently fail.

If the user asks to change a preference from elsewhere, reply: "Open the Preferences page; I can change settings there." Do not try to mutate preferences from a trip-detail or itinerary context.

When to use

Call into this skill when the user wants to change a long-term setting that affects future trips AND you are on the Preferences page. Typical phrasings:

"set my home airport to LAX"
"always plan in EUR"
"default trip length is 5 days"
"restore the demo seeds"

Do NOT use this for trip-specific edits — those go through trip-mutation skills (add-day-item, propose-flight, etc.) and target the active trip.

How to use

For a settings change:

Identify the field and value. The schema has homeAirport, preferredCurrency, defaultTripLengthDays, prefersAisleSeat, prefersWindowSeat.
Call update_preferences({ field, value }). The framework pops a confirm modal (mutating).
After approval, acknowledge in one sentence: "Home airport set to LAX."

For "restore the demo seeds":

The demo-seeds restore is a UI-only action exposed as a button on the Preferences page; it is NOT a tool the agent can call. Direct the user to the Preferences page button instead of trying to invoke a tool.

Anti-patterns

Do NOT change preferences silently — the confirm modal exists for a reason; the user's defaults shouldn't move without their nod.
Do NOT batch multiple preference changes into one update_preferences call; do them one at a time so each gets its own confirm gate.
Do NOT confuse trip-level edits with preference edits. "Use EUR for this trip" is a trip-level action, not a preference.