스킬 w-api-docs

📦

w-api-docs

Name: w-api-docs
Author: blockmatic

콘텐츠 리비전 r1 안전 ⚙️ 외부 명령어

Refresh API Docs from Source Schemas

API documentation can drift from the schemas and routes that define actual behavior. This skill guides updates from the owning source and keeps generated artifacts out of manual edits.

지원: Claude Codex Code(CC)

🥉 77 브론즈

Maintain this Skill? Claim it 🥉 77 브론즈

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청

Review the Skillstore skill "w-api-docs" from https://skillstore.io/skills/blockmatic-w-api-docs.md and its manifest at https://skillstore.io/api/skills/blockmatic-w-api-docs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/blockmatic-w-api-docs.md 서명된 manifest GET /api/skills/blockmatic-w-api-docs/manifest 서명된 lockfile GET /api/skills/blockmatic-w-api-docs/lockfile

테스트해 보기

"w-api-docs" 사용 중입니다. An endpoint response changed and the generated API reference is outdated.

예상 결과:

The response schema or route is the likely source of truth. Update that source, run the repository generator, check for drift, and revise adopter documentation only when behavior changed.

"w-api-docs" 사용 중입니다. A contributor proposes editing the generated OpenAPI file directly.

예상 결과:

Redirect the change to the owning schema or route. Regenerate the OpenAPI artifact using the documented workflow, then review the generated diff.

보안 감사

안전

v1 • 2026. 9. 20. 버전별 보고서 열기

The only static finding is a false positive. The referenced text is a Markdown command reference, not Ruby or shell execution, and no prompt injection or data-exfiltration intent is evident.

스캔된 파일

분석된 줄 수

검토 항목

오탐 무시됨

위험 요인

⚙️ 외부 명령어 (1)

SKILL.md:13

가장 최근에 완료된 정적·의미론적 감사에서 확인된 보안 발견 사항이 감지되지 않았습니다. 이는 스킬에 부작용이 없음을 증명하지 않습니다.

감사자: codex

이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기

보고서 링크 복사

https://skillstore.io/skills/blockmatic-w-api-docs/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

[![Skillstore security assessment](https://skillstore.io/badges/skills/blockmatic-w-api-docs/security.svg)](https://skillstore.io/skills/blockmatic-w-api-docs?utm_source=security_passport_badge)

HTML 배지

<a href="https://skillstore.io/skills/blockmatic-w-api-docs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/blockmatic-w-api-docs/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

임베드 카드

<iframe src="https://skillstore.io/embed/skills/blockmatic-w-api-docs.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

학술 인용 (APA · BibTeX · CFF)

APA 인용

blockmatic. (2026). w-api-docs security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/blockmatic-w-api-docs/audits/1

BibTeX 인용

@techreport{blockmatic-blockmatic-w-api-docs-2026,
  author = {blockmatic},
  title = {w-api-docs security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/blockmatic-w-api-docs/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "w-api-docs security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "blockmatic"
date-released: "2026-09-20"
url: "https://skillstore.io/skills/blockmatic-w-api-docs/audits/1"
identifiers:
  - type: other
    value: "skillstore:blockmatic-w-api-docs:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore 점수

이 점수의 이유 증거 신뢰도: 중간

아키텍처

유지보수성

콘텐츠

커뮤니티

사양 준수

만들 수 있는 것

Maintain OpenAPI References

Use the workflow to trace an endpoint change to its owning schema, regenerate the documentation, and check for drift.

Review Documentation Changes

Use the workflow to confirm that API docs describe implemented behavior without hand-editing generated files.

Coordinate Schema Updates

Use the workflow to plan source changes, generated documentation updates, and adopter MDX changes in one review.

이 프롬프트를 사용해 보세요

Find the Source of Truth

Trace this API documentation change to its owning schema, route, or documented generator. List the files and the evidence for each relationship.

Plan a Documentation Refresh

Review the requested API behavior change and produce a concise update plan. Separate source changes, generation steps, drift checks, and adopter documentation.

Validate Generated Docs

Inspect the repository workflow for generating API documentation. Identify the documented command, expected outputs, and available drift checks, then report any missing evidence.

Audit a Cross-Layer Change

Analyze this API change across schemas, routes, generated documentation, and adopter MDX. Recommend only source-owned edits and flag undocumented policy assumptions.

모범 사례

Trace every documentation change to an owning schema, route, or documented generator.
Run the repository generation and drift checks after changing API behavior.
Document only verified behavior and clearly separate evidence from assumptions.

피하기

Do not hand-edit generated OpenAPI files or generated clients.
Do not invent authentication, rate-limit, or versioning policy.
Do not update adopter documentation when the API behavior has not changed.

자주 묻는 질문

What problem does this skill solve?

It helps keep API documentation aligned with the schemas and routes that define actual behavior.

Should I edit generated OpenAPI files directly?

No. Change the owning schema or route, then use the repository generator.

What sources can own an API change?

The owning source may be a TypeBox schema, a Fastify route, or another documented repository source.

Does this skill run the generator?

It provides the workflow and decision guidance. The surrounding agent or developer must run repository commands.

Does it define authentication or rate limits?

No. It explicitly avoids inventing policies that the repository does not document.

When should adopter MDX change?

Update adopter MDX only when the API behavior changed and the existing guidance is affected.

개발자 세부 정보

작성자

blockmatic

라이선스

MIT

Skillstore 리비전

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/blockmatic/basilic-skills/tree/5fa16493413923e31f1df31f7260224f0f291d9e/skills/w-api-docs

참조

da80e8e31e67c66709203bc863d62c9424451362

유지보수 최신성

2026. 9. 20.

사용량

0 다운로드 · 0 조회

파일 구조

📄 SKILL.md