docs: update publish command documentation for well-known skills

- README.md: Add self-hosting section with well-known URI structure
- commands.mdx: Add Publishing Commands section
- marketplace.mdx: Expand publish section with self-hosting instructions
- skills.mdx: Add self-hosting workflow documentation

Documents the new `skillkit publish` workflow that generates RFC 8615
well-known URI structures for decentralized skill hosting.

Author: rohitg00

README.md

@@ -428,11 +428,31 @@ skillkit methodology load     # Load a methodology
 ### Publishing & Sharing
 
 ```bash
-skillkit publish              # Publish skill to marketplace
+skillkit publish              # Generate well-known hosting structure
+skillkit publish submit       # Submit to SkillKit marketplace
 skillkit create               # Create new skill
 skillkit init                 # Initialize in project
 ```
 
+#### Self-Hosting Skills (RFC 8615)
+
+Generate a well-known URI structure to host skills on your own domain:
+
+```bash
+# Generate hosting structure
+skillkit publish ./my-skills --output ./public
+
+# Users install from your domain
+skillkit add https://your-domain.com
+```
+
+This creates:
+```
+.well-known/skills/
+  index.json              # Skill manifest
+  my-skill/SKILL.md       # Skill files
+```
+
 ### Configuration
 
 ```bash

docs/fumadocs/content/docs/commands.mdx

@@ -233,10 +233,18 @@ skillkit init                  # Initialize project
 skillkit create <name>         # Create new skill
 skillkit validate [path]       # Validate skill format
 skillkit read <skills>         # Read skill content
-skillkit publish               # Publish to marketplace
 skillkit settings --set key=value  # Configure settings
 ```
 
+## Publishing Commands
+
+```bash
+skillkit publish [path]        # Generate well-known hosting structure
+skillkit publish --output dir  # Output to specific directory
+skillkit publish --dry-run     # Preview without writing
+skillkit publish submit        # Submit to SkillKit marketplace
+```
+
 ## Interactive TUI
 
 ```bash

docs/fumadocs/content/docs/marketplace.mdx

@@ -48,8 +48,39 @@ skillkit install anthropics/skills --agent claude-code,cursor
 
 ## Publish Skills
 
+### Self-Host on Your Domain (Recommended)
+
+Generate a well-known URI structure (RFC 8615) to host skills on your own domain:
+
 ```bash
+# Create and validate your skill
 skillkit create my-skill
 skillkit validate my-skill
-skillkit publish
+
+# Generate hosting structure
+skillkit publish ./my-skill --output ./public
+```
+
+This creates:
+```
+.well-known/skills/
+  index.json              # Skill manifest for auto-discovery
+  my-skill/
+    SKILL.md              # Your skill content
+```
+
+Deploy the `.well-known` folder to your web server. Users can then install via:
+
+```bash
+skillkit add https://your-domain.com
+```
+
+### Submit to SkillKit Marketplace
+
+To submit your skill for inclusion in the central marketplace:
+
+```bash
+skillkit publish submit
 ```
+
+This opens a GitHub issue for review by maintainers.

docs/fumadocs/content/docs/skills.mdx

@@ -94,6 +94,22 @@ Or manually create a `SKILL.md` file following the format above.
 # Test locally
 skillkit validate ./my-skill
 
-# Publish to marketplace
-skillkit publish
+# Generate well-known hosting structure for self-hosting
+skillkit publish ./my-skill --output ./public
+
+# Or submit to SkillKit marketplace
+skillkit publish submit
 ```
+
+### Self-Hosting
+
+The `skillkit publish` command generates an RFC 8615 well-known URI structure:
+
+```
+.well-known/skills/
+  index.json        # Manifest for auto-discovery
+  my-skill/
+    SKILL.md        # Skill content
+```
+
+Deploy to your domain and users can install via `skillkit add https://your-domain.com`.