diff --git a/README.md b/README.md
index 2a706dc..92497c5 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,7 @@ npx skills add https://github.com/stellar/stellar-dev-skill
 git clone https://github.com/stellar/stellar-dev-skill
 ```
 
-Copy the `skill/` directory contents to your assistant's skills location.
+Copy the `skills/stellar-dev/` directory contents to your assistant's skills location.
 
 | Agent | Skill Directory | Docs |
 |-------|-----------------|------|
@@ -58,20 +58,21 @@ Copy the `skill/` directory contents to your assistant's skills location.
 ## Skill Structure
 
 ```
-skill/
-├── SKILL.md                    # Main skill definition (required)
-├── contracts-soroban.md        # Soroban smart contract development
-├── frontend-stellar-sdk.md     # Frontend integration patterns
-├── testing.md                  # Testing strategies
-├── stellar-assets.md           # Asset issuance and management
-├── zk-proofs.md                # ZK proof architecture and verification patterns
-├── api-rpc-horizon.md          # API access (RPC/Horizon)
-├── security.md                 # Security checklist
-├── common-pitfalls.md          # Common issues and solutions
-├── advanced-patterns.md        # Advanced Soroban architecture patterns
-├── standards-reference.md      # SEP/CAP standards quick reference
-├── ecosystem.md                # DeFi protocols, wallets, tools, projects
-└── resources.md                # Curated reference links
+skills/
+└── stellar-dev/
+    ├── SKILL.md                    # Main skill definition (required)
+    ├── contracts-soroban.md        # Soroban smart contract development
+    ├── frontend-stellar-sdk.md     # Frontend integration patterns
+    ├── testing.md                  # Testing strategies
+    ├── stellar-assets.md           # Asset issuance and management
+    ├── zk-proofs.md                # ZK proof architecture and verification patterns
+    ├── api-rpc-horizon.md          # API access (RPC/Horizon)
+    ├── security.md                 # Security checklist
+    ├── common-pitfalls.md          # Common issues and solutions
+    ├── advanced-patterns.md        # Advanced Soroban architecture patterns
+    ├── standards-reference.md      # SEP/CAP standards quick reference
+    ├── ecosystem.md                # DeFi protocols, wallets, tools, projects
+    └── resources.md                # Curated reference links
 ```
 
 The skill uses a progressive disclosure pattern. The main `SKILL.md` provides core guidance, and the AI reads the specialized markdown files only when needed for specific tasks.
diff --git a/skill/SKILL.md b/skills/stellar-dev/SKILL.md
similarity index 100%
rename from skill/SKILL.md
rename to skills/stellar-dev/SKILL.md
diff --git a/skill/advanced-patterns.md b/skills/stellar-dev/advanced-patterns.md
similarity index 100%
rename from skill/advanced-patterns.md
rename to skills/stellar-dev/advanced-patterns.md
diff --git a/skill/api-rpc-horizon.md b/skills/stellar-dev/api-rpc-horizon.md
similarity index 100%
rename from skill/api-rpc-horizon.md
rename to skills/stellar-dev/api-rpc-horizon.md
diff --git a/skill/common-pitfalls.md b/skills/stellar-dev/common-pitfalls.md
similarity index 100%
rename from skill/common-pitfalls.md
rename to skills/stellar-dev/common-pitfalls.md
diff --git a/skill/contracts-soroban.md b/skills/stellar-dev/contracts-soroban.md
similarity index 100%
rename from skill/contracts-soroban.md
rename to skills/stellar-dev/contracts-soroban.md
diff --git a/skill/ecosystem.md b/skills/stellar-dev/ecosystem.md
similarity index 100%
rename from skill/ecosystem.md
rename to skills/stellar-dev/ecosystem.md
diff --git a/skill/frontend-stellar-sdk.md b/skills/stellar-dev/frontend-stellar-sdk.md
similarity index 100%
rename from skill/frontend-stellar-sdk.md
rename to skills/stellar-dev/frontend-stellar-sdk.md
diff --git a/skill/mpp.md b/skills/stellar-dev/mpp.md
similarity index 100%
rename from skill/mpp.md
rename to skills/stellar-dev/mpp.md
diff --git a/skill/resources.md b/skills/stellar-dev/resources.md
similarity index 100%
rename from skill/resources.md
rename to skills/stellar-dev/resources.md
diff --git a/skill/security.md b/skills/stellar-dev/security.md
similarity index 100%
rename from skill/security.md
rename to skills/stellar-dev/security.md
diff --git a/skill/standards-reference.md b/skills/stellar-dev/standards-reference.md
similarity index 100%
rename from skill/standards-reference.md
rename to skills/stellar-dev/standards-reference.md
diff --git a/skill/stellar-assets.md b/skills/stellar-dev/stellar-assets.md
similarity index 100%
rename from skill/stellar-assets.md
rename to skills/stellar-dev/stellar-assets.md
diff --git a/skill/testing.md b/skills/stellar-dev/testing.md
similarity index 100%
rename from skill/testing.md
rename to skills/stellar-dev/testing.md
diff --git a/skill/x402.md b/skills/stellar-dev/x402.md
similarity index 100%
rename from skill/x402.md
rename to skills/stellar-dev/x402.md
diff --git a/skill/zk-proofs.md b/skills/stellar-dev/zk-proofs.md
similarity index 100%
rename from skill/zk-proofs.md
rename to skills/stellar-dev/zk-proofs.md