docs: use server-side --traits filter from opensea-skill v2.2.3#7
Merged
Conversation
opensea-skill v2.2.3 added a `--traits` flag to three collection-scoped commands — `nfts list-by-collection`, `listings best`, and `events by-collection`. The previous attempt to document this on the copilot side (#6, closed) walked the agent through a client-side scan because the server filter didn't exist yet. Now it does. SOUL.md → How You Work: one bullet calling out the three endpoints that accept --traits, the AND-combine semantics, the OR workaround (one call per value + union token IDs), the empty-array vs error distinction, and the >1000-match 400 fallback. Points at the new "Server-side trait filtering" section in the skill for the full reference. No AGENTS.md change — the only reason the prior draft introduced `memory/trait_holders.<slug>.json` and a `trait_scans` cursor in `scan_state.json` was to support whole-collection scanning. Server-side filtering removes that need. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
--traitsflag to three collection-scoped commands:nfts list-by-collection,listings best,events by-collection. This PR teaches the copilot to use it instead of paginating + filtering client-side.SOUL.md→ How You Work covering the three endpoints, AND-combine semantics, the OR workaround (call-per-value + union), the empty-array vs error distinction, and the >1000-match 400 fallback. Points at the skill's Server-side trait filtering section for the full reference.memory/trait_holders.<slug>.jsonand atrait_scanscursor inscan_state.jsononly to support whole-collection scanning — server-side filtering removes the need for either.Test plan
workspace/SOUL.mdskills/opensea/SKILL.md→ Server-side trait filtering in the v2.2.3 skillgrep -ri "trait_holders\|trait_scans"should return nothing)🤖 Generated with Claude Code