Pages: API Introduction

Guides the API introduction page →typically at /api →that overviews the API, use cases, and links to documentation. API documentation (endpoint reference, code examples) lives on separate pages.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Initial Assessment

Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for product and developer use cases.

Identify:

1. API type: REST, GraphQL, etc.

   小蔥技能站7w4.net，專業的AI技能分享平臺。

2. Audience: Developers (integration) vs. decision makers (evaluation)
3. Docs location: Where API documentation lives (e.g. /docs, /api/reference, external)

Page Role

• API page (/api): Introduction, overview, value prop, CTA to docs or signup
• API documentation: Lives in docs (docs.*) → API Reference section with endpoint reference, auth, examples

Best Practices

Overview and Structure

• What the API does: Clear value proposition, key capabilities
• Use cases: Who uses it, common scenarios
• Getting started: Quick path to first call or docs
• Link to docs: Prominent CTA to API documentation

Content

• Key concepts: High-level, not endpoint-level detail
• Auth overview: How auth works; link to docs for details
• Pricing/limits: If relevant for evaluation
• SDKs and tools: If available; link to docs

SEO and Discovery

• Developer search: Target "API" + product/category terms
• Metadata: Title, description for developer intent
• Internal links: From homepage, features, resources

Output Format

• Structure outline (sections)
• Value proposition and key messages
• CTA to documentation or signup
• SEO metadata for developer search

Related Skills

• homepage-generator: Link to API page for developers
• schema-markup: WebPage or SoftwareApplication schema
• title-tag, meta-description, page-metadata: API page metadata

這個 Skill 質量中等偏上。它清晰地定義了 API 頁面生成的工作流程和要點，內容結構完整，比較好理解。優點是指南詳細、關聯清晰，缺點是隻有文字說明沒有示例，對新手不太友好，實際使用時要自己摸索。