We split this skill into the rules it gives an agent

19 rules. About 0 are common, 11 are distinctive, and 8 are very specific to this project.

• ≈0

  Common · estimate

  Many files like this have a rule of this kind.

• ≈11

  Distinctive · estimate

  This author's own choices. Worth a look.

• 8

  Very specific

  Tied to their project's names, files or tools. Probably skip.

• Common
• Distinctive
• Very specific

1. Distinctive:

   Use this skill when building or debugging PHP API integrations and SDKs with Saloon, including connectors, requests, authentication, …

   line 11
2. Very specific:

   Start with references/standalone-sdk-guidance.md and references/building-sdks.md.

   line 17
3. Very specific:

   Always use strongly typed DTOs for responses.

   line 19
4. Distinctive:

   If a request needs more than 2 or 3 parameters, or a DTO materially improves DX, use a typed DTO instead of a long parameter list.

   line 20
5. Distinctive:

   Add docblocks anywhere generics are required.

   line 22
6. Distinctive:

   If the API supports authentication, add it.

   line 23
7. Distinctive:

   Always support pagination if the API supports it.

   line 24
8. Distinctive:

   Always add rate limiting.

   line 25
9. Distinctive:

   Add custom exceptions, with a base SDK exception plus specific exceptions for common failures.

   line 28
10. Distinctive:

    Put the request and response on exceptions so developers can inspect them.

    line 29
11. Distinctive:

    Always write tests without hitting the real API.

    line 30
12. Distinctive:

    Keep Laravel support optional and isolated in its own namespace.

    line 34
13. Distinctive:

    Add the Laravel plugin as an optional dependency.

    line 35
14. Very specific:

    Use spatie/laravel-package-tools for package wiring.

    line 38
15. Very specific:

    Read references/index.md for the full page-by-page map.

    line 42
16. Very specific:

    Read references/standalone-sdk-guidance.md before designing a standalone client or package.

    line 43
17. Very specific:

    Read references/connectors.md, references/requests.md, and references/sending-requests.md before writing core Saloon code.

    line 44
18. Very specific:

    Read references/data-transfer-objects.md, references/middleware.md, references/building-sdks.md, and references/laravel-integration.md …

    line 45
19. Very specific:

    Read references/testing.md, references/handling-failures.md, and references/handling-rate-limits.md before shipping production integrations.

    line 46

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.