Agent skill

API Feature

by gocronx-team in gocronx-team/gocron

Implement or review an end-to-end gocron HTTP API change. An agent skill from gocronx-team/gocron.

MITAuto-check passedBackend & APIs

Install API Feature

skills CLI
$ npx skills add gocronx-team/gocron --skill api-feature -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gocronx-team/gocron api-feature --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gocronx-team/gocron.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/api-feature .claude/skills/api-feature && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
api-feature
GitHub stars
808
Token cost
~1.2k tokens
SKILL.md length
550 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Implement or review an end-to-end gocron HTTP API change. An agent skill from gocronx-team/gocron.

  • Changing Gin routes
  • SKILL.md covers Compatibility invariants, Performance invariants, Trace the existing path and Implement the complete contract, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Response payloads

What it does

API Feature is an agent skill from gocronx-team/gocron. Implement or review an end-to-end gocron HTTP API change. Use when adding or changing Gin routes, handlers, request or response payloads, authorization, audit behavior, frontend API clients, API types, OpenAPI-style documentation, or API tests.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Backend & APIs, covering REST APIs, OpenAPI specifications and API testing. It works with OpenAPI. The repository describes itself as: distributed scheduled task management system. The licence is MIT.

When your agent uses it

  • Changing Gin routes
  • Response payloads
  • Frontend API clients
  • OpenAPI-style documentation

Example prompts

  • “/api-feature”

What it can do on your machine

Read from SKILL.md and the folder at commit e76e9da. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Feature loads about 1.2k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 550 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gocronx-team/gocron at commit e76e9da, republished under its MIT licence (© gocronx-team). 550 words, ~1,151 tokens.

Download SKILL.mdSave it as .claude/skills/api-feature/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
api-feature
description
Implement or review an end-to-end gocron HTTP API change. Use when adding or changing Gin routes, handlers, request or response payloads, authorization, audit behavior, frontend API clients, API types, OpenAPI-style documentation, or API tests.

Build a gocron API feature

Keep the route, authorization rule, handler, frontend client, types, translations, documentation, and tests as one change.

Compatibility invariants

  • When the contract changes, preserve both deployment orders: an N frontend/client must tolerate an N-1 backend, and an N backend must serve N-1 frontends/clients.
  • Keep routes, methods, accepted requests, response fields and types, status codes, pagination, and SSE event contracts stable. New response fields must be optional; new request fields must have compatible defaults.
  • Detect new server capabilities before depending on them. If N-1 lacks an endpoint, field, or stream behavior, retain a safe legacy path or hide it.
  • Never repurpose an existing field or error code. Breaking contracts require explicit approval, a major version, and migration/rollout/rollback plans.

Performance invariants

  • Bound every collection response and expensive input. Require pagination, maximum page sizes, upload/body limits, and bounded filters where applicable.
  • Prevent N+1 queries and per-row remote calls. Capture query counts for list endpoints and inspect query plans for new filters, sorting, or joins.
  • For polling and SSE, bound connection/resource use, clean up on disconnect, avoid per-client database polling where sharing is safe, and apply backpressure or a documented drop/coalescing policy.
  • Do not return or retain unbounded task output/logs. Use paging, cursors, bounded chunks, or streaming with cancellation.
  • Benchmark materially affected high-traffic or high-volume endpoints with representative data and report applicable metrics.

Trace the existing path

  • Inspect neighboring registrations in internal/routers/routers.go, handlers under internal/routers, models/services called by the handler, and the matching frontend module under web/gocronx-admin/src/api.
  • Identify every middleware applied to the route group. Classify the endpoint as public, authenticated, admin-only, API-token accessible, or agent-facing.
  • Search path allowlists and permission maps before adding a route. Never make an endpoint public merely to make a request succeed.
  • Preserve the response conventions in internal/routers/base. Do not expose raw database, filesystem, command, provider, or secret errors to clients.
Show full SKILL.md (244 more words)Show less

Implement the complete contract

  • Use the appropriate HTTP method. Mutating operations must not use GET.
  • Bind into an explicit request type, validate required fields and bounds, and reject unknown or dangerous input where the existing API pattern permits.
  • Enforce authorization server-side before loading or mutating protected data. For resource ids, verify access to the resource rather than only validating that the caller is logged in.
  • Use transactions for multi-write operations. Add an audit event for security-sensitive or administrative mutations following existing patterns.
  • Update the frontend API wrapper and src/types/api/api.d.ts when the UI uses the endpoint. Keep backend and frontend field names/types aligned.
  • Add both Chinese and English strings when user-visible text changes: backend internal/modules/i18n/{zh_cn,en_us}.go, frontend src/locales/langs/{zh,en}.json.
  • Update docs/zh/guide/api.md for a public API contract. Include auth, parameters, example response, error behavior, and compatibility impact.

Test risk, not just success

Add focused tests for:

  • valid requests and stable response shape;
  • missing, malformed, boundary, and nonexistent-resource input;
  • unauthenticated and unauthorized callers;
  • ownership or tenant boundary where applicable;
  • duplicate submissions or retry behavior for mutations;
  • secret/error redaction for sensitive endpoints.
  • N-1 requests/responses and both frontend/backend deployment orders when the feature crosses that boundary.

Run the changed router package with race detection, then relevant service/model tests. Run frontend type checking when the contract is consumed by the UI. Finally invoke $verify before committing.

Report the route and method, authorization class, contract changes, backward compatibility, tests added, performance evidence when relevant, and any documentation or i18n files intentionally left unchanged.

© gocronx-team, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/api-feature of gocronx-team/gocron.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e76e9da

Compare with similar skills

API Feature next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Feature compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Feature this skillgocronx-team/gocron808—~1.2kAutomated safety check: PassMIT
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
Dotnet Webapidotnet/skills5.6k2 repos~5.5kAutomated safety check: PassMIT
Add API Resourcewso2/agent-manager105—~1.1kAutomated safety check: PassApache-2.0
API DesignWrongStack/WrongStack368—~1.3kAutomated safety check: PassMIT
API Designeraiskillstore/marketplace4301 repos~3.6kAutomated safety check: PassNone

Similar skills

  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Dotnet Webapi

    dotnet/skills

    Official

    Guides creation and modification of ASP.NET Core Web API endpoints with correct HTTP semantics, OpenAPI metadata, and error handling.

    5.6k GitHub starsUsed in 2 repos~5.5k tokens
    Backend & APIsAuto-check passed
  • Add API Resource

    wso2/agent-manager

    Add or change a REST API resource in agent-manager-service (the Go control plane).

    105 GitHub stars~1.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • API Design

    WrongStack/WrongStack

    A skill your agent uses when designing, implementing, or reviewing an HTTP API — endpoints, request and response shapes, errors, pagination, versioning, and authorization.

    368 GitHub stars~1.3k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • API Designer

    aiskillstore/marketplace

    Design and document RESTful and GraphQL APIs with OpenAPI/Swagger specifications, authentication patterns, versioning strategies, and best practices.

    430 GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed

More from gocronx-team/gocron

All 8 skills in this repo
  • Migration

    gocronx-team/gocron

    Create, review, or verify gocron database migrations across SQLite, MySQL, and PostgreSQL.

    808 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Security Check

    gocronx-team/gocron

    Audit or harden gocron security across Go, pnpm workspaces, containers, authentication, authorization, secrets, command execution, SSRF, and dependency vulnerabilities.

    808 GitHub stars~690 tokensUpdated 5 days ago
    Auto-check passed
  • Dependency Update

    gocronx-team/gocron

    Review, apply, verify, or merge gocron dependency updates from Dependabot or manual requests.

    808 GitHub stars~891 tokensUpdated 5 days ago
    Auto-check passed
  • Scheduler Change

    gocronx-team/gocron

    Safely implement, diagnose, or review changes to gocron scheduling and task execution.

    808 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Release

    gocronx-team/gocron

    Prepare or publish a safe gocron release by choosing a SemVer bump, updating AppVersion and migrations, invoking the complete verification gate, committing, checking CI, and creating an annotated tag.

    808 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Release

    gocronx-team/gocron

    Cut a gocron release — bump AppVersion, align the migration version id, run the full CI check locally, and tag only when everything is green.

    808 GitHub stars~586 tokensUpdated 5 days ago
    Auto-check passed

Works with

Categories

Questions about API Feature

What does API Feature do?

Implement or review an end-to-end gocron HTTP API change. An agent skill from gocronx-team/gocron. API Feature is an agent skill from gocronx-team/gocron. Implement or review an end-to-end gocron HTTP API change.

When should I use API Feature?

API Feature fits situations like: changing Gin routes; response payloads; frontend API clients; openAPI-style documentation.

How do I install API Feature in Claude Code?

Run `npx skills add gocronx-team/gocron --skill api-feature -a claude-code`. Or copy the skill folder (.agents/skills/api-feature in gocronx-team/gocron) into .claude/skills/api-feature in your project. Claude Code loads it when a task matches its description.

How do I install API Feature in Codex?

Run `npx skills add gocronx-team/gocron --skill api-feature -a codex`. Or copy the skill folder (.agents/skills/api-feature in gocronx-team/gocron) into .agents/skills/api-feature in your project. Codex loads it when a task matches its description.

Can I use API Feature in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gocronx-team/gocron --skill api-feature -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-feature, .gemini/skills/api-feature, .github/skills/api-feature and .opencode/skills/api-feature in your project.

What does API Feature need to run?

SKILL.md names no scripts, command-line tools or credentials: API Feature is instructions for the agent only.

Does API Feature access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Feature safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does API Feature use?

API Feature is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Feature use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Feature?

Skills that share tags, products or a category with API Feature: Use Yaak (mountain-loop/yaak, 19k stars), Dotnet Webapi (dotnet/skills, 5.6k stars), Add API Resource (wso2/agent-manager, 105 stars) and API Design (WrongStack/WrongStack, 368 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Feature?

gocronx-team (a GitHub organization) maintains it in gocronx-team/gocron, which has 808 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 2, 2026.

Source: gocronx-team/gocron on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.