refactor: Comply with Agent Skills spec and add npx install support

- Restructure to skills/humanizerai/ directory (name must match folder)
- Update SKILL.md frontmatter with license, metadata, allowed-tools
- Add LICENSE file (MIT)
- Update README with npx skills add installation option
- Add compatibility section for Claude Code, Cursor, Windsurf

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 HumanizerAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,27 +1,34 @@
 # HumanizerAI Agent Skills
 
-Agent skills for [HumanizerAI](https://humanizerai.com) - AI detection and text humanization for Claude Code.
+Agent skills for [HumanizerAI](https://humanizerai.com) - AI detection and text humanization.
 
 ## Features
 
-- `/detect-ai` - Check if text is AI-generated
+- `/detect-ai` - Check if text is AI-generated (free)
 - `/humanize` - Make AI text undetectable
 
 ## Installation
 
-### Option 1: Copy to your project
+### Option 1: Using npx (Recommended)
+
+```bash
+npx skills add humanizerai/agent-skills
+```
+
+### Option 2: Clone to your project
+
+```bash
+git clone https://github.com/humanizerai/agent-skills.git
+cp -r agent-skills/skills/humanizerai .claude/skills/
+```
+
+### Option 3: Manual copy
 
 Copy the skill files to your project's `.claude/skills/humanizerai/` directory:
 
 ```bash
 mkdir -p .claude/skills/humanizerai
-cp SKILL.md detect-ai.md humanize.md api-reference.md examples.md .claude/skills/humanizerai/
-```
-
-### Option 2: Clone the repository
-
-```bash
-git clone https://github.com/humanizerai/agent-skills.git .claude/skills/humanizerai
+# Copy files from skills/humanizerai/ to .claude/skills/humanizerai/
 ```
 
 ## Setup
@@ -36,23 +43,26 @@ export HUMANIZERAI_API_KEY="hum_your_api_key_here"
 ## Usage
 
 ### Detect AI Content
+
 ```
 /detect-ai [your text here]
 ```
 
 ### Humanize Text
+
 ```
 /humanize [your text here]
 ```
 
 With intensity option:
+
 ```
 /humanize --intensity aggressive [your text here]
 ```
 
 ## Intensity Levels
 
-| Level | Name | Description | Use Case |
+| Value | Name | Description | Use Case |
 |-------|------|-------------|----------|
 | `light` | Light | Subtle changes | Low AI scores, preserve style |
 | `medium` | Medium | Balanced (default) | Most use cases |
@@ -72,6 +82,14 @@ Plans:
 - Pro: $19.99/mo - 50,000 words/month
 - Business: $49.99/mo - 200,000 words/month
 
+## Compatibility
+
+Works with:
+- [Claude Code](https://claude.ai/code)
+- [Cursor](https://cursor.sh)
+- [Windsurf](https://codeium.com/windsurf)
+- Any agent supporting the [Agent Skills](https://agentskills.io) format
+
 ## Support
 
 - Documentation: https://humanizerai.com/docs/api

skills/humanizerai/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: humanizerai
 description: Detect AI-generated content and humanize text to bypass AI detectors. Use when the user wants to check if text is AI-generated, make AI text undetectable, or bypass GPTZero/Turnitin.
-user-invocable: true
+license: MIT
+metadata:
+  author: humanizerai
+  version: "1.0.0"
+  website: https://humanizerai.com
+allowed-tools: WebFetch Bash
 ---
 
 # HumanizerAI Skill