Cursor errors
Agent skills for the Cursor TypeScript SDK, the agent CLI, and .cursor/ project config (rules, skills, hooks, mcp). Skill-graph format with [[wikilinks]].
npx -y skills add HKTITAN/cursor-sdk --skill cursor-errorsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 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
CursorAgentError class hierarchy, isRetryable, and recovery patterns. Use when classifying SDK failures, building retry logic, or surfacing actionable messages.
SKILL.md
1.3 KB, as published. Nobody here has run it
cursor-errors
Every SDK throw is a CursorAgentError (or subclass). The isRetryable flag is your routing decision: retry transient errors, surface terminal ones.
Base class
- [[references/cursor-agent-error]] —
isRetryable,code,cause,protoErrorCode
Subclasses
- [[references/auth-error]] —
AuthenticationError - [[references/rate-limit]] —
RateLimitError - [[references/configuration]] —
ConfigurationError - [[references/integration-not-connected]] —
IntegrationNotConnectedError - [[references/network]] —
NetworkError - [[references/unknown-agent]] —
UnknownAgentError - [[references/unsupported-op]] —
UnsupportedRunOperationError
Patterns
- [[references/retry-pattern]] — backoff using
isRetryable - [[references/schema-stability]] — defensive parsing of tool call args/result
Cross-links
- Run status terminal-error vs throw — [[../cursor-runs/references/wait]]
- Operation gating — [[../cursor-runs/references/operation-support]]