SKILL.md
Introspection & Raw GraphQL
Read only the reference for your active surface: MCP or CLI. The workflows below use shared operation names and arguments.
Schema discovery, organization info, and a fallback executor.
This is Tier 2 in the resolution strategy: when a dedicated operation fails or doesn't exist, use introspection to understand the API, then execute_graphql to run the operation directly.
If a dedicated write reports failure, re-read the target before trying a mutation through execute_graphql. Continue only when the read shows the write did not land. If the result is inconclusive, report it and stop; a second create can duplicate data.
Tier 1: dedicated operation exists — use it.
Tier 2: use introspection + execute_graphql (this skill).
Tier 3: direct curl/httpx fallback — see pipefy-api-fallback.
Tools
Introspection & Raw GraphQL
Read only the reference for your active surface: MCP or CLI. The workflows below use shared operation names and arguments.
Schema discovery, organization info, and a fallback executor.
This is Tier 2 in the resolution strategy: when a dedicated operation fails or doesn't exist, use introspection to understand the API, then execute_graphql to run the operation directly.
If a dedicated write reports failure, re-read the target before trying a mutation through execute_graphql. Continue only when the read shows the write did not land. If the result is inconclusive, report it and stop; a second create can duplicate data.
Tier 1: dedicated operation exists — use it.
Tier 2: use introspection + execute_graphql (this skill).
Tier 3: direct curl/httpx fallback — see pipefy-api-fallback.