Redefining system

.github/workflows/build-index.yml

@@ -33,117 +33,113 @@ jobs:
             process.exit(0);
           }
 
-          const categoryDirs = fs.readdirSync(skillsDir, { withFileTypes: true })
-            .filter(d => d.isDirectory());
-
-          for (const categoryDir of categoryDirs) {
-            const categoryPath = path.join(skillsDir, categoryDir.name);
-            const skillDirs = fs.readdirSync(categoryPath, { withFileTypes: true })
-              .filter(d => d.isDirectory());
-
-            for (const skillDir of skillDirs) {
-              const skillFile = path.join(categoryPath, skillDir.name, 'SKILL.md');
-              if (!fs.existsSync(skillFile)) continue;
-
-              const content = fs.readFileSync(skillFile, 'utf8');
-              const fmMatch = content.match(/^---\s*([\s\S]*?)\s*---\s*/);
-              if (!fmMatch) continue;
-
-              const fm = {};
-              let currentKey = null;
-              for (const line of fmMatch[1].split(/\r?\n/)) {
-                if (!line.trim()) continue;
-                const arrMatch = line.match(/^\s*-\s+(.*)$/);
-                if (arrMatch && currentKey) {
-                  if (!Array.isArray(fm[currentKey])) fm[currentKey] = [];
-                  fm[currentKey].push(arrMatch[1].trim());
-                  continue;
-                }
-                const kvMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-                if (!kvMatch) continue;
-                const key = kvMatch[1];
-                const val = kvMatch[2];
-                if (val === '') {
-                  fm[key] = [];
-                  currentKey = key;
-                } else {
-                  const trimmed = val.trim();
-                  const isInlineArray =
-                    (key === 'requires' || key === 'examples') &&
-                    trimmed.startsWith('[') &&
-                    trimmed.endsWith(']');
-
-                  if (isInlineArray) {
-                    let arr = null;
-                    try {
-                      const parsed = JSON.parse(trimmed);
-                      if (Array.isArray(parsed)) {
-                        arr = parsed.map((x) => String(x));
-                      }
-                    } catch (_) {}
-
-                    if (!arr) {
-                      const inner = trimmed.slice(1, -1).trim();
-                      if (!inner) {
-                        arr = [];
-                      } else {
-                        const parts = [];
-                        let buf = '';
-                        let quote = null;
-                        for (let i = 0; i < inner.length; i++) {
-                          const ch = inner[i];
-                          if (quote) {
-                            if (ch === quote && inner[i - 1] !== '\\') {
-                              quote = null;
-                            }
-                            buf += ch;
-                            continue;
-                          }
-
-                          if (ch === '"' || ch === "'") {
-                            quote = ch;
-                            buf += ch;
-                            continue;
-                          }
-
-                          if (ch === ',') {
-                            parts.push(buf.trim());
-                            buf = '';
-                            continue;
+          const skillDirs = fs.readdirSync(skillsDir, { withFileTypes: true })
+            .filter(d => d.isDirectory())
+            .sort((a, b) => a.name.localeCompare(b.name));
+
+          for (const skillDir of skillDirs) {
+            const skillFile = path.join(skillsDir, skillDir.name, 'SKILL.md');
+            if (!fs.existsSync(skillFile)) continue;
+
+            const content = fs.readFileSync(skillFile, 'utf8');
+            const fmMatch = content.match(/^---\s*([\s\S]*?)\s*---\s*/);
+            if (!fmMatch) continue;
+
+            const fm = {};
+            let currentKey = null;
+            for (const line of fmMatch[1].split(/\r?\n/)) {
+              if (!line.trim()) continue;
+              const arrMatch = line.match(/^\s*-\s+(.*)$/);
+              if (arrMatch && currentKey) {
+                if (!Array.isArray(fm[currentKey])) fm[currentKey] = [];
+                fm[currentKey].push(arrMatch[1].trim());
+                continue;
+              }
+              const kvMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+              if (!kvMatch) continue;
+              const key = kvMatch[1];
+              const val = kvMatch[2];
+              if (val === '') {
+                fm[key] = [];
+                currentKey = key;
+              } else {
+                const trimmed = val.trim();
+                const isInlineArray =
+                  (key === 'requires' || key === 'examples') &&
+                  trimmed.startsWith('[') &&
+                  trimmed.endsWith(']');
+
+                if (isInlineArray) {
+                  let arr = null;
+                  try {
+                    const parsed = JSON.parse(trimmed);
+                    if (Array.isArray(parsed)) {
+                      arr = parsed.map((x) => String(x));
+                    }
+                  } catch (_) {}
+
+                  if (!arr) {
+                    const inner = trimmed.slice(1, -1).trim();
+                    if (!inner) {
+                      arr = [];
+                    } else {
+                      const parts = [];
+                      let buf = '';
+                      let quote = null;
+                      for (let i = 0; i < inner.length; i++) {
+                        const ch = inner[i];
+                        if (quote) {
+                          if (ch === quote && inner[i - 1] !== '\\') {
+                            quote = null;
                           }
+                          buf += ch;
+                          continue;
+                        }
 
+                        if (ch === '"' || ch === "'") {
+                          quote = ch;
                           buf += ch;
+                          continue;
+                        }
+
+                        if (ch === ',') {
+                          parts.push(buf.trim());
+                          buf = '';
+                          continue;
                         }
-                        if (buf.trim()) parts.push(buf.trim());
 
-                        arr = parts
-                          .map((s) => s.replace(/^['\"]|['\"]$/g, '').trim())
-                          .filter(Boolean);
+                        buf += ch;
                       }
+                      if (buf.trim()) parts.push(buf.trim());
+
+                      arr = parts
+                        .map((s) => s.replace(/^['\"]|['\"]$/g, '').trim())
+                        .filter(Boolean);
                     }
+                  }
 
-                    fm[key] = arr;
+                  fm[key] = arr;
+                } else {
+                  let scalar = trimmed;
+                  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+                    try {
+                      scalar = JSON.parse(trimmed);
+                    } catch (_) {
+                      scalar = trimmed.replace(/^['\"]|['\"]$/g, '');
+                    }
                   } else {
-                    fm[key] = val.replace(/^['\"]|['\"]$/g, '');
+                    scalar = trimmed.replace(/^['\"]|['\"]$/g, '');
                   }
-                  currentKey = null;
+                  fm[key] = scalar;
                 }
+                currentKey = null;
               }
-
-              const body = content.slice(fmMatch[0].length).trim();
-
-              skills.push({
-                skillId: fm.id || skillDir.name,
-                name: fm.name || skillDir.name,
-                description: fm.description || '',
-                instructions: body,
-                author: fm.author || 'community',
-                version: fm.version || '1.0.0',
-                category: fm.category || 'other',
-                requires: Array.isArray(fm.requires) ? fm.requires : [],
-                examples: Array.isArray(fm.examples) ? fm.examples : [],
-              });
             }
+
+            skills.push({
+              name: fm.name || skillDir.name,
+              description: fm.description || '',
+            });
           }
 
           skills.sort((a, b) => a.name.localeCompare(b.name));

CONTRIBUTING.md

@@ -15,14 +15,18 @@ A skill is a set of natural language instructions that guide an AI agent's behav
 
 ## Skill File Format
 
-Each skill lives in its own directory: `skills/{skill-id}/SKILL.md`
+Each skill lives in its own directory directly under `skills/`, with a `SKILL.md` entrypoint. Support folders such as `scripts/`, `references/`, and `assets/` belong to that skill and are not indexed separately:
+
+- `skills/{skill-id}/SKILL.md`
+- `skills/{skill-id}/references/{supporting-file}`
+- `skills/{skill-id}/scripts/{supporting-script}`
 
 ```markdown
 ---
 id: your-skill-id
 name: Your Skill Name
 description: A concise description of what this skill does (shown to the LLM).
-category: productivity
+category: Development
 author: your-github-username
 version: 1.0.0
 requires: []
@@ -41,10 +45,10 @@ Include any specific formatting, steps, or constraints.
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Unique identifier (lowercase, hyphens). Must match the directory name. |
+| `id` | string | Unique identifier (lowercase, hyphens). Must match the skill directory name. |
 | `name` | string | Human-readable display name |
 | `description` | string | What the skill does (max 200 chars). This is shown to the LLM as the tool description. |
-| `category` | string | One of: `productivity`, `development`, `communication`, `writing`, `research`, `other` |
+| `category` | string | One of the supported Skills Store categories listed below. |
 
 ### Optional Frontmatter Fields
 
@@ -57,12 +61,18 @@ Include any specific formatting, steps, or constraints.
 
 ### Categories
 
-- **productivity** -- Task management, planning, organization
-- **development** -- Coding, debugging, code review, DevOps
-- **communication** -- Email drafting, messaging, social media
-- **writing** -- Content creation, editing, summarization
-- **research** -- Data analysis, fact-checking, literature review
-- **other** -- Everything else
+- **Lifestyle**
+- **Blockchain**
+- **Databases**
+- **Research**
+- **Content & Media**
+- **Documentation**
+- **Testing & Security**
+- **DevOps**
+- **Data & AI**
+- **Business**
+- **Development**
+- **Tools**
 
 ## Guidelines
 

README.md

@@ -38,31 +38,33 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions on how to creat
 skills/
   prep-meeting/
     SKILL.md
-  contract-review/
-    SKILL.md
-  draft-reply/
+    scripts/
+    references/
+  react-performance/
     SKILL.md
+    assets/
   ...
 index.json          # Auto-generated manifest (do not edit manually)
 ```
 
+Each skill directory lives directly under `skills/`. Support folders such as `scripts/`, `references/`, and `assets/` belong to that skill and are not indexed separately.
+
 ## Categories
 
 Each skill declares a `category` in its frontmatter. Categories help users browse the Skills Store and should reflect the user-facing purpose of the skill.
 
 Common categories you’ll see:
-- Productivity
-- Communication
-- Business
 - Lifestyle
-- Content & Media
-- Development
-- Data & AI
+- Blockchain
+- Databases
 - Research
+- Content & Media
 - Documentation
-- Design
-- DevOps
 - Testing & Security
+- DevOps
+- Data & AI
+- Business
+- Development
 - Tools
 
 Use the most specific, user-friendly category that matches the skill’s primary intent. If a skill spans multiple domains, pick the category users would most likely search.