myaidev-method 0.3.1 → 0.3.3

package/TECHNICAL_ARCHITECTURE.md

@@ -1,8 +1,8 @@
 # MyAIDev Method - Technical Architecture Guide
 
-**Version**: 0.2.1
+**Version**: 0.3.3
 **Target Audience**: Developers, System Architects, Contributors
-**Last Updated**: 2025-10-16
+**Last Updated**: 2026-02-10
 
 ## Table of Contents
 
@@ -84,11 +84,11 @@ myaidev-method/
 │       └── mcp-launcher.js             # MCP lifecycle manager
 ├── skills/                             # Skill definitions
 │   ├── content-writer/SKILL.md         # Content writing skill
-│   ├── sparc-architect/SKILL.md        # SPARC architecture skill
-│   ├── sparc-coder/SKILL.md            # SPARC coding skill
-│   ├── sparc-tester/SKILL.md           # SPARC testing skill
-│   ├── sparc-reviewer/SKILL.md         # SPARC review skill
-│   ├── sparc-documenter/SKILL.md       # SPARC documentation skill
+│   ├── myaidev-architect/SKILL.md        # SPARC architecture skill
+│   ├── myaidev-coder/SKILL.md            # SPARC coding skill
+│   ├── myaidev-tester/SKILL.md           # SPARC testing skill
+│   ├── myaidev-reviewer/SKILL.md         # SPARC review skill
+│   ├── myaidev-documenter/SKILL.md       # SPARC documentation skill
 │   ├── wordpress-publisher/SKILL.md    # WordPress publishing skill
 │   ├── coolify-deployer/SKILL.md       # Coolify deployment skill
 │   └── configure/SKILL.md              # Platform configuration skill
@@ -816,11 +816,101 @@ if (await confirmProduction()) {
 
 ## Skill System
 
+### Two-Tier Skill Strategy
+
+MyAIDev Method employs a **two-tier skill architecture** that balances open community innovation with premium cloud-hosted capabilities.
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    MyAIDev Skill Ecosystem                       │
+│                                                                 │
+│  ┌───────────────────────────┐  ┌────────────────────────────┐  │
+│  │  TIER 1: Open Source      │  │  TIER 2: Premium Cloud     │  │
+│  │  Community Marketplace    │  │  MyAIDev Platform API      │  │
+│  │                           │  │                            │  │
+│  │  • Free to use            │  │  • Auth token required     │  │
+│  │  • Community contributed  │  │  • Cloud-hosted execution  │  │
+│  │  • PR-based review        │  │  • API-delivered via       │  │
+│  │  • Curated & vetted       │  │    dev.myai1.ai            │  │
+│  │  • Local execution        │  │  • Advanced capabilities   │  │
+│  │  • SKILL.md installed     │  │  • Managed & maintained    │  │
+│  │    to .claude/skills/     │  │    by MyAIDev team         │  │
+│  └───────────────────────────┘  └────────────────────────────┘  │
+│                                                                 │
+│  CLI: addon install <name>      CLI: (authenticated API calls)  │
+│  Slash: /find-skills            Slash: (auto-provisioned)       │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+#### Tier 1: Open Source Community Skills
+
+Open source skills are the foundation of the MyAIDev ecosystem. They are contributed by the community, distributed via the [MyAIDev Marketplace](https://github.com/myaione/myaidev-marketplace), and installed locally as `SKILL.md` files.
+
+| Aspect | Detail |
+|--------|--------|
+| **Distribution** | `myaidev-marketplace` GitHub repository |
+| **Cost** | Free |
+| **Contribution** | Anyone via PR-based submission (`addon submit`) |
+| **Review process** | Automated CI validation + manual review by maintainers |
+| **Security vetting** | Scanned for destructive commands, credential access, dynamic code execution, and malware patterns |
+| **Quality curation** | Frontmatter validation, content structure checks, documentation requirements |
+| **Execution** | Local — runs inside the user's Claude Code session |
+| **Installation** | `addon install <name>` copies `SKILL.md` to `.claude/skills/` |
+| **Discovery** | `addon list`, `addon search`, `/find-skills` slash command |
+
+**Security & Quality Pipeline**:
+```
+Contributor submits PR
+  → CI validates (frontmatter, structure, size limits)
+  → CI security scan (destructive commands, credential paths, eval/exec, curl|sh)
+  → CI checks for binary files and disallowed file types
+  → Maintainer reviews code quality, usefulness, and safety
+  → Merge triggers webhook → skill ingested to marketplace database
+  → Users can install verified skills
+```
+
+#### Tier 2: Premium Cloud-Hosted Skills
+
+Premium skills are proprietary capabilities provided by the MyAIDev platform. They run server-side via authenticated API calls and offer advanced functionality not available in the open source tier.
+
+| Aspect | Detail |
+|--------|--------|
+| **Distribution** | API from `dev.myai1.ai` |
+| **Cost** | Premium (subscription or usage-based) |
+| **Authentication** | Requires auth token from `dev.myai1.ai` (`myaidev-method login`) |
+| **Maintenance** | Managed and maintained by the MyAIDev team |
+| **Execution** | Cloud-hosted — processing happens server-side |
+| **Capabilities** | Advanced AI pipelines, proprietary integrations, managed infrastructure tools |
+| **Updates** | Automatic — always the latest version via API |
+| **SLA** | Platform uptime and support guarantees |
+
+**Access Flow**:
+```
+User authenticates (myaidev-method login)
+  → Auth token stored locally (~/.myaidev/auth.json)
+  → CLI/skill makes authenticated API call to dev.myai1.ai
+  → Platform executes premium capability server-side
+  → Results returned to user's session
+```
+
+#### Tier Comparison
+
+| Feature | Tier 1 (Open Source) | Tier 2 (Premium Cloud) |
+|---------|---------------------|----------------------|
+| Cost | Free | Subscription |
+| Execution | Local | Cloud-hosted |
+| Source | Community | MyAIDev team |
+| Updates | Manual reinstall | Automatic via API |
+| Offline use | Yes | No (requires network) |
+| Customizable | Yes (edit SKILL.md) | No (managed service) |
+| Review process | PR-based | Internal QA |
+| Support | Community | Platform support |
+
 ### Skill Architecture
 
 Skills are markdown files (`SKILL.md`) organized in dedicated directories under `skills/`.
 
-**Skill Definition Structure**:
+**Skill Definition Structure** (applies to Tier 1 open source skills):
 ```markdown
 <!-- skills/skill-name/SKILL.md -->
 ---
@@ -958,11 +1048,11 @@ Capabilities:
 #### 8. SPARC Architecture Skills
 ```yaml
 Files:
-  - skills/sparc-architect/SKILL.md   # Architecture design
-  - skills/sparc-coder/SKILL.md       # Code implementation
-  - skills/sparc-tester/SKILL.md      # Test creation
-  - skills/sparc-reviewer/SKILL.md    # Code review
-  - skills/sparc-documenter/SKILL.md  # Documentation
+  - skills/myaidev-architect/SKILL.md   # Architecture design
+  - skills/myaidev-coder/SKILL.md       # Code implementation
+  - skills/myaidev-tester/SKILL.md      # Test creation
+  - skills/myaidev-reviewer/SKILL.md    # Code review
+  - skills/myaidev-documenter/SKILL.md  # Documentation
 Purpose: Full SPARC development workflow
 ```
 
@@ -984,11 +1074,11 @@ Skills are invoked directly by name as Claude Code skills.
 5. `/mintlify-publish` → Mintlify publishing
 6. `/astro-publish` → Astro publishing
 7. `/coolify-deployer` → Coolify deployment
-8. `/sparc-architect` → Architecture design
-9. `/sparc-coder` → Code implementation
-10. `/sparc-tester` → Test creation
-11. `/sparc-reviewer` → Code review
-12. `/sparc-documenter` → Documentation
+8. `/myaidev-architect` → Architecture design
+9. `/myaidev-coder` → Code implementation
+10. `/myaidev-tester` → Test creation
+11. `/myaidev-reviewer` → Code review
+12. `/myaidev-documenter` → Documentation
 13. `/configure` → Platform configuration
 
 ---
@@ -1828,6 +1918,7 @@ iconType: "solid"                   # Icon style
 - **Skill**: AI-powered capability defined in a `SKILL.md` file within a dedicated `skills/` directory
 - **API-Based Publishing**: Content publishing via HTTP APIs (WordPress, PayloadCMS)
 - **CLI**: Command Line Interface
+- **Community Skill**: Tier 1 open source skill contributed via the marketplace PR review process
 - **Coolify**: Self-hosted Platform-as-a-Service (PaaS) for application deployment
 - **Frontmatter**: YAML metadata at the top of markdown files
 - **Git-Based Publishing**: Content publishing via file operations and git workflow
@@ -1835,8 +1926,11 @@ iconType: "solid"                   # Icon style
 - **JWT**: JSON Web Token for authentication
 - **Lexical**: Rich text editor format used by PayloadCMS
 - **MCP**: Model Context Protocol for AI tool integration
+- **MyAIDev Marketplace**: GitHub-hosted repository for curated open source skill distribution
 - **Nixpacks**: Automatic build system used by Coolify
+- **Premium Skill**: Tier 2 cloud-hosted skill provided via authenticated API calls to dev.myai1.ai
 - **Skill Invocation**: Claude Code skill invoked with `/skill-name`
+- **Skill Tier**: Classification of skills as open source (Tier 1) or premium cloud-hosted (Tier 2)
 - **Static Site Generator**: Tool that generates static HTML from markdown (Docusaurus, Astro)
 - **Sub-skill**: Delegated skill for parallel task execution
 - **Token**: Authentication credential or AI context unit

package/USER_GUIDE.md

@@ -104,7 +104,7 @@ Use the interactive configuration command to set up your environment—no manual
 
 ```bash
 # SPARC Development Workflow
-/sparc-workflow "Build user authentication system"
+/myaidev-workflow "Build user authentication system"
 
 # Create professional content
 /content-writer "10 Best Remote Work Tips"
@@ -124,10 +124,27 @@ Use the interactive configuration command to set up your environment—no manual
 
 **New in v0.2.25!** MyAIDev Method now supports a modern plugin-based architecture with discoverable skills, cross-platform compatibility, and marketplace distribution.
 
+### Two-Tier Skill Strategy
+
+MyAIDev Method provides two categories of skills:
+
+**Tier 1: Open Source Community Skills** — Free skills contributed by the community and distributed via the [MyAIDev Marketplace](https://github.com/myaione/myaidev-marketplace). Every skill is stringently curated, tested, and vetted for malware and quality before reaching users. Install with `addon install <name>`, run locally in your Claude Code session, and customize by editing the SKILL.md file.
+
+**Tier 2: Premium Cloud-Hosted Skills** — Advanced skills and tools provided by the MyAIDev platform via authenticated API calls to `dev.myai1.ai`. These are cloud-hosted, managed by the MyAIDev team, and offer premium capabilities beyond what open source skills provide. Requires an auth token (`myaidev-method login`).
+
+| | Open Source (Tier 1) | Premium Cloud (Tier 2) |
+|---|---|---|
+| **Cost** | Free | Subscription |
+| **Execution** | Local | Cloud-hosted |
+| **Source** | Community | MyAIDev team |
+| **Customizable** | Yes | No (managed) |
+| **Offline** | Yes | No |
+
 ### What's New
 
 - **Skills-Based Architecture**: Capabilities are now defined as discoverable SKILL.md files
-- **Plugin Marketplace**: Install packs from the MyAIDev marketplace
+- **Plugin Marketplace**: Install community skills from the MyAIDev marketplace
+- **Premium Cloud Skills**: Access advanced capabilities via authenticated API
 - **Cross-Platform Support**: Works with Claude Code, Gemini CLI, and Codex CLI
 - **Dual Command Naming**: Both legacy (`/myai-*`) and new skill-based names work
 - **Installation Detection**: CLI commands to detect and upgrade installations
@@ -168,7 +185,7 @@ Skills are organized into packs for modular installation:
 | Pack | Skills | Use Case |
 |------|--------|----------|
 | **content** | content-writer, content-verifier, visual-generator, wordpress-publisher | Content creation and publishing |
-| **development** | sparc-architect, sparc-coder, sparc-tester, sparc-reviewer, sparc-documenter | SPARC methodology software development |
+| **development** | myaidev-workflow, myaidev-architect, myaidev-coder, myaidev-tester, myaidev-reviewer, myaidev-documenter, myaidev-analyze, myaidev-debug, myaidev-refactor, myaidev-performance, myaidev-migrate | SPARC methodology software development |
 | **security** | security-tester, security-auditor | Penetration testing and auditing |
 | **infrastructure** | coolify-deployer, openstack-manager | Deployment and cloud management |
 
@@ -487,12 +504,12 @@ cp -r .myaidev-method-backup-{timestamp}/* .
 Contains all skill definitions as SKILL.md files, organized by category:
 
 **SPARC Development:**
-- `skills/sparc-workflow/SKILL.md` - Complete 5-phase SPARC workflow
-- `skills/sparc-architect/SKILL.md` - Architecture design phase
-- `skills/sparc-coder/SKILL.md` - Implementation phase
-- `skills/sparc-tester/SKILL.md` - Testing phase
-- `skills/sparc-reviewer/SKILL.md` - Code review phase
-- `skills/sparc-documenter/SKILL.md` - Documentation phase
+- `skills/myaidev-workflow/SKILL.md` - Complete 5-phase SPARC workflow
+- `skills/myaidev-architect/SKILL.md` - Architecture design phase
+- `skills/myaidev-coder/SKILL.md` - Implementation phase
+- `skills/myaidev-tester/SKILL.md` - Testing phase
+- `skills/myaidev-reviewer/SKILL.md` - Code review phase
+- `skills/myaidev-documenter/SKILL.md` - Documentation phase
 
 **Content & Publishing:**
 - `skills/content-writer/SKILL.md` - Content creation
@@ -979,7 +996,7 @@ The SPARC methodology provides systematic development with five phases:
 **Full Workflow Execution**:
 ```bash
 # Execute complete 5-phase SPARC workflow
-/sparc-workflow "Build user authentication with JWT and OAuth"
+/myaidev-workflow "Build user authentication with JWT and OAuth"
 ```
 
 This runs:
@@ -992,19 +1009,19 @@ This runs:
 **Individual Phase Control**:
 ```bash
 # Architecture phase
-/sparc-architect "Design microservices architecture for e-commerce platform"
+/myaidev-architect "Design microservices architecture for e-commerce platform"
 
 # Implementation phase
-/sparc-coder "Implement user authentication service"
+/myaidev-coder "Implement user authentication service"
 
 # Testing phase
-/sparc-tester "Create comprehensive test suite with 80%+ coverage"
+/myaidev-tester "Create comprehensive test suite with 80%+ coverage"
 
 # Code review phase
-/sparc-reviewer "Review authentication implementation for security best practices"
+/myaidev-reviewer "Review authentication implementation for security best practices"
 
 # Documentation phase
-/sparc-documenter "Generate API documentation and integration guides"
+/myaidev-documenter "Generate API documentation and integration guides"
 ```
 
 #### Spec-Driven Development
@@ -1013,10 +1030,10 @@ Start with requirements, not code:
 
 ```bash
 # 1. Create detailed specification
-/sparc-architect "Design RESTful API for social media platform with posts, comments, likes"
+/myaidev-architect "Design RESTful API for social media platform with posts, comments, likes"
 
 # 2. Generate pseudocode and algorithms
-/sparc-workflow "Implement the social media API based on specification"
+/myaidev-workflow "Implement the social media API based on specification"
 
 # 3. Implementation follows the spec
 # Skills reference the specification throughout development
@@ -1028,13 +1045,13 @@ Start with requirements, not code:
 
 ```bash
 # Build: Implement feature
-/sparc-coder "Add real-time notifications using WebSockets"
+/myaidev-coder "Add real-time notifications using WebSockets"
 
 # Measure: Test and validate
-/sparc-tester "Create integration tests for WebSocket notifications"
+/myaidev-tester "Create integration tests for WebSocket notifications"
 
 # Analyze: Code review and quality checks
-/sparc-reviewer "Analyze WebSocket implementation for performance and security"
+/myaidev-reviewer "Analyze WebSocket implementation for performance and security"
 
 # Deploy: Prepare for production
 /coolify-deployer "Deploy notification service to production"
@@ -1061,19 +1078,19 @@ Complete feature development:
 
 ```bash
 # 1. Design phase - Architecture and specification
-/sparc-architect "Design comment system with threading, reactions, and moderation"
+/myaidev-architect "Design comment system with threading, reactions, and moderation"
 
 # 2. Implementation phase
-/sparc-coder "Implement comment API endpoints with validation"
+/myaidev-coder "Implement comment API endpoints with validation"
 
 # 3. Testing phase
-/sparc-tester "Create unit and integration tests for comment system"
+/myaidev-tester "Create unit and integration tests for comment system"
 
 # 4. Review phase
-/sparc-reviewer "Review comment system code for security and performance"
+/myaidev-reviewer "Review comment system code for security and performance"
 
 # 5. Documentation phase
-/sparc-documenter "Generate API documentation for comment endpoints"
+/myaidev-documenter "Generate API documentation for comment endpoints"
 
 # 6. Git workflow
 /myai-git-commit "Add threaded comment system with reactions"
@@ -1088,18 +1105,18 @@ Complete feature development:
 **Multi-Skill Collaboration**:
 ```bash
 # Architecture skill designs system
-/sparc-architect "Design event-driven microservices architecture"
+/myaidev-architect "Design event-driven microservices architecture"
 
 # Multiple skills work in parallel
-/sparc-coder "Implement user service"
-/sparc-coder "Implement order service"
-/sparc-coder "Implement notification service"
+/myaidev-coder "Implement user service"
+/myaidev-coder "Implement order service"
+/myaidev-coder "Implement notification service"
 
 # Testing skill validates integration
-/sparc-tester "Create end-to-end tests for order flow"
+/myaidev-tester "Create end-to-end tests for order flow"
 
 # Documentation skill generates guides
-/sparc-documenter "Generate microservices integration documentation"
+/myaidev-documenter "Generate microservices integration documentation"
 ```
 
 ---
@@ -1115,7 +1132,7 @@ The SPARC methodology provides a systematic approach to software development wit
 Run the entire 5-phase workflow:
 
 ```bash
-/sparc-workflow "Build user authentication with JWT and OAuth"
+/myaidev-workflow "Build user authentication with JWT and OAuth"
 ```
 
 This executes all phases sequentially:
@@ -1131,19 +1148,19 @@ For more control, run phases individually:
 
 ```bash
 # Phase 1: Architecture Design
-/sparc-architect "Design microservices architecture for e-commerce platform"
+/myaidev-architect "Design microservices architecture for e-commerce platform"
 
 # Phase 2: Implementation
-/sparc-coder "Implement user authentication service"
+/myaidev-coder "Implement user authentication service"
 
 # Phase 3: Testing
-/sparc-tester "Create comprehensive test suite with 80%+ coverage"
+/myaidev-tester "Create comprehensive test suite with 80%+ coverage"
 
 # Phase 4: Code Review
-/sparc-reviewer "Review authentication implementation for security"
+/myaidev-reviewer "Review authentication implementation for security"
 
 # Phase 5: Documentation
-/sparc-documenter "Generate API documentation and user guides"
+/myaidev-documenter "Generate API documentation and user guides"
 ```
 
 ### SPARC Quality Standards
@@ -2421,7 +2438,7 @@ done
 
 ```bash
 # Step 1: API analysis and planning
-/sparc-documenter "Analyze REST API" --source "api-spec.yaml" --generate_examples true
+/myaidev-documenter "Analyze REST API" --source "api-spec.yaml" --generate_examples true
 # Output: api-analysis.md with endpoints, parameters, and usage patterns
 
 # Step 2: Create comprehensive documentation
@@ -2440,7 +2457,7 @@ done
 /docusaurus-publisher "api-docs-docusaurus.md" --section "api" --add_try_it_buttons true
 
 # Step 5: Generate SDK documentation
-/sparc-documenter "Generate SDK Examples" --languages "javascript,python,curl" --source "api-docs.md"
+/myaidev-documenter "Generate SDK Examples" --languages "javascript,python,curl" --source "api-docs.md"
 /docusaurus-publisher "sdk-examples.md" --section "sdks" --code_tabs true
 ```
 
@@ -2691,6 +2708,220 @@ DEBUG=false
    - Test skill behavior
    - Validate output quality
 
+## 🎁 Contributing Skills to the Marketplace
+
+Share your custom skills with the community as **Tier 1 open source skills** through the MyAIDev marketplace. All contributed skills go through a stringent review process — automated CI validation checks for security vulnerabilities, destructive commands, and malware patterns, followed by manual maintainer review for quality and usefulness. The contribution system uses a PR-based review workflow.
+
+### Quick Start: Skill Contributor Skill
+
+The easiest way to create and submit skills is using the `/skill-contributor` skill inside Claude Code:
+
+```bash
+# Interactive menu - choose what you want to do
+/skill-contributor
+
+# Create a new skill with guided prompts
+/skill-contributor create
+
+# Validate and submit an existing skill via PR
+/skill-contributor submit
+
+# Check the status of your submissions
+/skill-contributor status
+```
+
+### Complete Contribution Workflow
+
+#### Step 1: Authenticate
+
+Before submitting skills, authenticate with the marketplace:
+
+```bash
+npx myaidev-method login
+```
+
+This opens your browser for OAuth authentication and stores a token locally.
+
+#### Step 2: Create Your Skill
+
+**Option A: Using the skill-contributor skill (Recommended)**
+
+```bash
+/skill-contributor create
+```
+
+You'll be prompted for:
+- **Name**: lowercase with hyphens (e.g., `code-formatter`)
+- **Description**: Include a "when to use" clause
+- **Category**: development, content, publishing, security, deployment, infrastructure, or other
+- **Complexity**: basic, intermediate, or advanced (determines template)
+
+**Option B: Manual creation**
+
+Create a directory and SKILL.md file:
+
+```bash
+mkdir -p .claude/skills/my-skill
+```
+
+Create `.claude/skills/my-skill/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: "Does X when you need to Y. Use when working with Z."
+argument-hint: "[action] [args]"
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion]
+context: fork
+---
+
+# My Skill
+
+You are a **My Skill** agent — description of what you do.
+
+## Quick Start
+
+```
+/my-skill action args
+```
+
+## Arguments
+
+Parse action from: `$ARGUMENTS`
+
+### Actions
+
+#### `action1` - Primary Action
+
+**Workflow:**
+1. Step one
+2. Step two
+3. Step three
+
+## Error Handling
+
+- Explain errors and suggest alternatives
+- Never silently skip steps
+```
+
+#### Step 3: Validate Your Skill
+
+Run validation to check for issues before submitting:
+
+```bash
+# Via CLI
+npx myaidev-method addon validate --dir .claude/skills/my-skill
+
+# Via skill-contributor
+/skill-contributor submit
+# (validates automatically before submission)
+```
+
+**Validation checks:**
+- ✅ Required frontmatter fields (`name`, `description`, `allowed-tools`)
+- ✅ Content structure (H1 heading, sections)
+- ✅ Security patterns (no credential paths, no destructive commands)
+- ✅ File size limits (50KB max per file, 200KB max total)
+- ✅ Name availability (not already taken in marketplace)
+
+#### Step 4: Submit for Review
+
+```bash
+# Via CLI
+npx myaidev-method addon submit --dir .claude/skills/my-skill
+
+# Via skill-contributor
+/skill-contributor submit
+```
+
+This will:
+1. Fork the [myaidev-marketplace](https://github.com/myaione/myaidev-marketplace) repo
+2. Create a branch with your skill
+3. Open a PR for review
+4. Record your submission in the system
+
+#### Step 5: Track Your Submission
+
+```bash
+# Check all your submissions
+npx myaidev-method addon status
+
+# Or via skill-contributor
+/skill-contributor status
+```
+
+### Skill Quality Guidelines
+
+#### Frontmatter Requirements
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | ✅ | Lowercase, hyphens only, max 64 chars |
+| `description` | ✅ | Must include "when" clause explaining usage |
+| `allowed-tools` | ✅ | Array of tools the skill needs |
+| `argument-hint` | Recommended | Shows usage pattern in help |
+| `context` | Recommended | Usually `fork` for isolation |
+
+#### Content Structure
+
+- **H1 heading**: Must match skill purpose
+- **Quick Start**: Show basic usage example
+- **Arguments section**: Document all arguments and actions
+- **Workflow steps**: Clear numbered steps for each action
+- **Error handling**: Guidance for edge cases
+
+#### Security Rules
+
+Your skill must NOT contain:
+- ❌ Credential paths (`~/.ssh`, `~/.aws`, etc.)
+- ❌ Destructive commands (`rm -rf /`, `chmod 777`, etc.)
+- ❌ Dynamic code execution (`eval()`, `exec()`) unless essential
+- ❌ Remote script piping (`curl | bash`)
+
+### Skill Templates
+
+The skill-contributor provides three templates based on complexity:
+
+| Template | Best For | Features |
+|----------|----------|----------|
+| **Basic** | Simple, single-action skills | Minimal structure, quick to fill |
+| **Intermediate** | Multi-action skills | Multiple actions, quality checks |
+| **Advanced** | Orchestrator skills | Sub-agents via Task tool, configuration |
+
+### After Submission
+
+1. **CI Validation**: GitHub Actions validates your SKILL.md automatically
+2. **Review**: Maintainers review for quality, security, and usefulness
+3. **Feedback**: You may receive comments requesting changes
+4. **Merge**: Once approved, your skill is merged and ingested into the marketplace
+5. **Published**: Users can install via `npx myaidev-method addon install your-skill`
+
+### Example: Creating a Simple Skill
+
+```bash
+# 1. Login
+npx myaidev-method login
+
+# 2. Create skill interactively
+/skill-contributor create
+# Enter: name=code-formatter, description="Formats code files. Use when cleaning up code style.", category=development, complexity=basic
+
+# 3. Edit the generated SKILL.md with your logic
+code .claude/skills/code-formatter/SKILL.md
+
+# 4. Test locally by invoking it
+/code-formatter "src/**/*.js"
+
+# 5. Validate
+npx myaidev-method addon validate --dir .claude/skills/code-formatter
+
+# 6. Submit
+/skill-contributor submit
+
+# 7. Check status
+/skill-contributor status
+```
+
 ## 📚 Additional Resources
 
 ### Learning More