agentleFS
DankosikDankosik/golang-backend-skills/skills/go-http/SKILL.md

go-http

Skill0 starsChanged 2 months agoMITView on GitHub

Implement or review Go HTTP routing, middleware, request/response contracts, and streaming behavior.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Translation: Follow the affected request from its mounted route through middleware to the application operation and client-visible result.

    line 8
  2. Distinctive:

    Use the router's composition and standard HTTP machinery before inventing adapters.

    line 10

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Go HTTP

Translation. Follow the affected request from its mounted route through middleware to the application operation and client-visible result. Preserve the selected router or framework and its conventions. Honor requirements and preserve settled choices outside the requested change.

Use the router's composition and standard HTTP machinery before inventing adapters. For a new dependency decision, consider supported ServeMux capabilities. Middleware order, nesting, method handling, redirects, and fallbacks are observable behavior; preserve the relevant serving path without migrating unrelated routes.

Decode bounded input into intentional types. Distinguish malformed transport input from business rejection, and absent fields from explicit zero values where the contract requires it. Keep trusted identity separate from caller-controlled fields. Map errors into the established public format without leaking internals; return after completing a response.

Carry request context into downstream work. Choose body limits and transport deadlines for the actual interaction, including uploads and streams. A context timeout does not forcibly stop a handler. Preserve flushing and other required response capabilities through middleware. Once headers or stream bytes are committed, failure cannot become an ordinary replacement response. Never use ResponseWriter after the handler returns.

Verify changed routing, middleware, encoding, and failure behavior through the mounted handler chain; httptest.ResponseRecorder can cover those in-process contracts. Calling only the leaf handler omits router and middleware behavior. Use a real test server and client for socket deadlines, disconnects, or transport streaming claims, not for every endpoint change. Report the boundary actually exercised.

For review-only work, do not edit files. Cite the affected route and client-visible contract; inspect mounted middleware before claiming validation, authorization, or error handling is missing.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.