AGENT SKILL

appworld-api-preflight-verification

AppWorld tasks requiring bulk or mutating API work across records, playlists, notes, or pages. Use when the solver is about to loop over API results; verify the exact task target set, endpoint pagination limits, and actual response schema before bulk operations.

License 许可
Apache-2.0
所属仓库
RUC-NLPIR/FlashRSI
最近更新
2026-11-12
Stars
★ 394
Forks
23

01 前言 Front Matter

name
appworld-api-preflight-verification
flashrsi
{ "level": "general", "algorithm": "evo_harness", "source_task_ids": [ "ce359b5_2", "ce359b5_3", "b0a8eae_1", "b0a8eae_2" ] }
description
AppWorld tasks requiring bulk or mutating API work across records, playlists, notes, or pages. Use when the solver is about to loop over API results; verify the exact task target set, endpoint pagination limits, and actual response schema before bulk operations.

03 SKILL.md 正文

AppWorld API preflight: verify target set, limits, and schema first

Failures across Spotify and simple_note tasks share one pattern: the solver assumed API behavior or task scope and started bulk work before checking the actual API/task constraints.

Preflight checklist

  1. Re-read the task and fix the concrete target set before mutating. Defaults can be wrong in destructive scopes (e.g., "my song library and playlists" requires both show_playlist_library and show_liked_playlists).
  2. Probe one record before looping. Print a sample response and access only keys observed or documented there; do not assume fields such as album_title.
  3. Check pagination limits before bulk fetching. Prefer page_limit=20 with page_index iteration; an over-large page_limit returns HTTP 422.
  4. Use focused query parameters for targeted lookup. Empty queries return recency/pinned-first pages that can bury the target record.

During and after

  • Stop on the first unexpected error (KeyError, 422, 401) and inspect the actual response/docs, then rerun with corrected arguments.
  • Verify accumulated results cover the full target set before answering or marking the task complete.

This is a cross-task planning/verification skill. App-specific procedures stay in their topic skills; this skill enforces preflight checks before bulk API work.

04 同仓库更多 Skills

RUC-NLPIR
RUC-NLPIR/FlashRSI

dynamic-resources

Example skill loaded from resources_discover

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

hermes-agent

Use the FlashRSI Hermes Snapshot's headless Python runtime, tools, sessions, and compression paths.

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

skill-installer

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

review-agent

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

★ 394
RUC-NLPIR
RUC-NLPIR/FlashRSI

plugin-creator

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.

★ 394