search
Find an app on the App Store / Google Play and start tracking it in AppFollow, then hand structured app references to the feedback-analysis and aso-analysis skills. Read-only search + dedupe works on any plan; the add step degrades gracefully when the plan does not allow writes. Trigger on "find app X", "track our app", "add <app> to AppFollow".
How do I install this agent skill?
npx skills add https://github.com/appfollow/appfollow-ai-toolkit --skill searchIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The search skill for AppFollow enables app tracking by searching external stores and managing collections. It incorporates safety features such as explicit user approval for account changes and plan-based error handling. The skill possesses an indirect prompt injection surface due to the ingestion of external app metadata, though the risk is mitigated by required human confirmation for write actions.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
search — find + track apps
Read using-appfollow first (session opening, write ritual, error codes).
Inputs
query: app name (free-text search keywords).store: the short store code —as(App Store) orgp(Google Play) for the search;add_apptakes all ten codes (theusing-appfollowskill'sreferences/tool-map.md).country(defaultus),collection(name; created if new),locale.
Flow
- Session:
whoami(seeusing-appfollow). - Normalize input. Search takes free-text keywords only — the ASO search endpoints do not accept
a store URL or an
ext_id. Trim the query to the app name (strip any pasted URL down to the app name/title before searching). - Search (read-only, any plan). Call
aso_search_results(optionallyaso_search_suggestions, 12 cr). Present numbered candidates. Auto-pick only a single exact-title match; otherwise the user picks. - Resolve collection.
list_collections. If the target collection is new, runadd_collection_preview→ user approval →add_collection. - Dedupe (read-only).
list_apps(apps_id= the target collection'scollectionId); if the app'sextIdis already there, record it underskipped_existingand skip the add.list_appsreportsstoreas the long name (itunes=as,googleplay=gp). - Add (write — may be plan-gated).
add_app_preview→ explicit user approval →add_appwith identical args:store(short code),ext_id,apps_id,locale(two-letter country code). Passis_competitor: trueonly when the user says the app is a rival (default: one of their own). - Verify.
list_appsagain; confirm the app'sextIdnow appears; keep the collection'sapps_idwith it — the report skills address the app byapps_id+ext_id. A wrong add is undone withremove_app_preview→ explicit approval →remove_app(samestore,ext_id,apps_id). Checkget_creditsfirst: withremainingbelow 200 the removal may be refused, so do not offer it then. Before the approval, tell the user the removal costs 200 credits and show the app'slist_appsrow (title,store,isCompetitor), or, for an archived app (not listed bylist_apps), itsext_idandstore. After the removal, re-check withlist_appsthat the app is gone (for an archived app, the{ok: true}of the confirmed call is the confirmation). Then leave that app out of the emittedaddedlist and count both the add and the remove incredits_spent_estimate(add 0, remove 200 cr). - Emit the JSON block (below).
Read-only degrade path (plan-gated writes)
add_collection requires an Advanced API / Custom plan; neither it nor add_app carries a
feature gate — so a plan block does not arrive as FEATURE_DISABLED. It can surface as
ACCESS_DENIED, VALIDATION_ERROR (on add_app, a full apps or competitors limit), or
UPSTREAM_ERROR. Therefore:
- Always complete search + dedupe (read-only — works on any plan).
- Attempt the
add_*confirm. - On any error code from the add, do not assert a specific code. Report the candidate refs you
found, state plainly that the add could not be completed (likely a plan limitation), and list the
found refs under
not_addedso the report skills can still target them (they may already be tracked).
Output (fenced JSON)
{
"added": [{"store": "as", "ext_id": "389801252", "apps_id": 12345, "collection": "Core apps", "locale": "us", "title": "Example App"}],
"skipped_existing": [],
"not_added": [],
"collection_created": null,
"credits_spent_estimate": 12
}
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/appfollow/appfollow-ai-toolkit/search">View search on skillZs</a>