apple-docs 1.0.1 → 1.0.5

package/README.md

@@ -16,7 +16,9 @@ Or run directly:
 npx apple-docs search "SwiftUI List"
 ```
 
-### Claude Code Skill
+## Agent Skill
+
+Install as a skill for Claude Code, Cursor, Windsurf, and 40+ other AI agents:
 
 ```bash
 npx skills add mtcnbzks/apple-docs-cli
@@ -24,6 +26,8 @@ npx skills add mtcnbzks/apple-docs-cli
 
 Then use `/apple-docs` in Claude Code to query Apple documentation.
 
+Browse on [skills.sh](https://skills.sh) or learn more about the [skills ecosystem](https://github.com/vercel-labs/skills).
+
 ## Usage
 
 ```
@@ -104,10 +108,19 @@ apple-docs updates --technology SwiftUI --year 2025
 apple-docs overviews --platform ios
 ```
 
+### Version
+
+```bash
+apple-docs version
+apple-docs --version
+apple-docs -v
+```
+
 ## Flags
 
 | Flag | Description |
 |------|-------------|
+| `--version`, `-v` | Show current version |
 | `--type <type>` | Symbol/search type filter (class, struct, enum, protocol) |
 | `--limit <n>` | Max results |
 | `--year <year>` | Year filter |

package/dist/cli.js

@@ -1,6 +1,13 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
 import { callTool } from './mcp.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
 const [, , command, ...rest] = process.argv;
+if (command === '--version' || command === '-v' || command === 'version') {
+    console.log(version);
+    process.exit(0);
+}
 function parseArgs(argv) {
     const positional = [];
     const flags = {};
@@ -25,6 +32,7 @@ const num = (key) => flags[key] ? parseInt(flags[key], 10) : undefined;
 const HELP = `Usage: apple-docs <command> [args] [--flags]
 
 Commands:
+  version                     Show current version
   search <query>              Search Apple documentation
   doc <url>                   Get documentation content
   tech [category]             List Apple technologies
@@ -53,7 +61,8 @@ Flags:
   --query <q>           Search query filter
   --technology <t>      Technology filter
   --language <lang>     Language filter (swift, occ)
-  --depth <d>           Search depth (shallow, medium, deep)`;
+  --depth <d>           Search depth (shallow, medium, deep)
+  --version, -v         Show version`;
 function need(val, usage) {
     if (!val) {
         console.error(usage);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "apple-docs",
-	"version": "1.0.1",
+	"version": "1.0.5",
 	"description": "CLI for querying Apple Developer Documentation — search docs, browse frameworks, WWDC videos, sample code, and API analysis",
 	"license": "MIT",
 	"author": "mtcnbzks",
@@ -34,7 +34,8 @@
 		"prepublishOnly": "npm run build"
 	},
 	"files": [
-		"dist"
+		"dist",
+		"skills"
 	],
 	"dependencies": {
 		"@kimsungwhee/apple-docs-mcp": "^1.0.26"

package/skills/apple-docs/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: apple-docs
+description: Search Apple Developer Documentation — APIs, frameworks, WWDC videos, sample code, and platform compatibility. Uses the apple-docs CLI to fetch real-time data from developer.apple.com.
+---
+
+# apple-docs
+
+Query Apple Developer Documentation from the command line. Provides real-time access to API docs, framework symbols, WWDC video transcripts and code examples, sample code, and platform compatibility info.
+
+## When to use
+
+- When you need up-to-date Apple API documentation (SwiftUI, UIKit, Foundation, etc.)
+- When checking platform availability or minimum OS versions
+- When looking for WWDC session content, transcripts, or code examples
+- When exploring framework symbols (classes, structs, protocols, enums)
+- When finding sample code from Apple
+- When discovering related or alternative APIs
+
+## Setup
+
+```bash
+npx apple-docs search "SwiftUI"
+```
+
+Or install globally:
+
+```bash
+npm i -g apple-docs
+```
+
+## Instructions
+
+Based on the user's question: $ARGUMENTS
+
+1. Determine which `apple-docs` command(s) best answer the question
+2. Run them using the Bash tool
+3. Present the results concisely, focusing on what the user needs
+
+## Commands
+
+```
+apple-docs version                     # Show current version
+apple-docs search <query>              # Search Apple documentation
+apple-docs doc <url>                   # Get full doc page content
+apple-docs tech [category]             # List Apple technologies/frameworks
+apple-docs symbols <framework>         # Browse framework symbols (--type class|struct|enum|protocol)
+apple-docs wwdc [year]                 # Browse WWDC videos
+apple-docs wwdc-search <query>         # Search WWDC transcripts & code
+apple-docs wwdc-video <year> <id>      # Get WWDC video transcript + code
+apple-docs wwdc-code [framework]       # Get WWDC code examples
+apple-docs wwdc-topics [topicId]       # Browse WWDC topics
+apple-docs wwdc-years                  # List available WWDC years
+apple-docs sample [query]              # Browse sample code
+apple-docs related <url>               # Find related APIs
+apple-docs similar <url>               # Find similar/alternative APIs
+apple-docs platform <url>              # Check platform compatibility
+apple-docs updates [category]          # Documentation updates
+apple-docs overviews [category]        # Technology overviews
+apple-docs references <url>            # Resolve API references
+```
+
+## Flags
+
+- `--type <type>` — Symbol type filter (class, struct, enum, protocol)
+- `--limit <n>` — Max results
+- `--year <year>` — Year filter
+- `--framework <fw>` — Framework filter
+- `--topic <topic>` — Topic filter
+- `--platform <p>` — Platform filter (ios, macos, watchos, tvos, visionos)
+- `--language <lang>` — Language filter (swift, occ)
+- `--depth <d>` — Search depth (shallow, medium, deep)
+
+## Tips
+
+- Start with `search` for general questions
+- Use `doc <url>` to get full details on a specific API found in search results
+- Use `symbols <framework> --type <type>` to find specific classes/structs/protocols
+- Use `platform <url>` to check OS version requirements
+- Use `wwdc-search` to find implementation guidance from WWDC talks
+- Chain commands when needed: search → doc → related