@framers/agentos-skills-registry 0.2.0 → 0.2.1

package/dist/workspace-discovery.js

@@ -0,0 +1,211 @@
+/**
+ * @fileoverview Cross-Agent Skill Discovery (Feature 3.5)
+ *
+ * Discovers SKILL.md files from a workspace `.agents/skills/` directory,
+ * parses their YAML frontmatter, and returns them as SkillCatalogEntry[]
+ * compatible with the existing registry catalog.
+ *
+ * Workspace skills take priority over registry skills when names collide.
+ *
+ * @module @framers/agentos-skills-registry/workspace-discovery
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+// ── Frontmatter parser ──────────────────────────────────────────────────────
+/**
+ * Lightweight YAML frontmatter parser.
+ *
+ * Handles the subset of YAML used in SKILL.md frontmatter:
+ *   - scalar key: value pairs
+ *   - inline arrays  [a, b, c]
+ *   - block arrays   (- item)
+ *
+ * Does NOT pull in a full YAML dependency — keeps the package lightweight.
+ */
+export function parseSkillFrontmatter(content) {
+    // Extract frontmatter block between leading --- fences
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return null;
+    const block = match[1];
+    const result = {};
+    const lines = block.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Skip blank lines and deep-nested keys (metadata sub-objects)
+        if (!line.trim() || /^\s{2,}\S/.test(line)) {
+            i++;
+            continue;
+        }
+        const kvMatch = line.match(/^(\w[\w_-]*)\s*:\s*(.*)/);
+        if (!kvMatch) {
+            i++;
+            continue;
+        }
+        const key = kvMatch[1];
+        let rawValue = kvMatch[2].trim();
+        // Inline array: [a, b, c]
+        if (rawValue.startsWith('[') && rawValue.endsWith(']')) {
+            const inner = rawValue.slice(1, -1);
+            result[key] = inner
+                ? inner.split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, ''))
+                : [];
+            i++;
+            continue;
+        }
+        // Block array: subsequent lines starting with "- "
+        if (rawValue === '' || rawValue === '[]') {
+            const items = [];
+            let j = i + 1;
+            while (j < lines.length) {
+                const next = lines[j];
+                const itemMatch = next.match(/^\s+-\s+(.*)/);
+                if (!itemMatch)
+                    break;
+                items.push(itemMatch[1].trim().replace(/^['"]|['"]$/g, ''));
+                j++;
+            }
+            if (items.length > 0) {
+                result[key] = items;
+                i = j;
+                continue;
+            }
+            // Empty array literal
+            if (rawValue === '[]') {
+                result[key] = [];
+                i++;
+                continue;
+            }
+        }
+        // Scalar value — strip surrounding quotes
+        result[key] = rawValue.replace(/^['"]|['"]$/g, '');
+        i++;
+    }
+    // name is required
+    if (typeof result.name !== 'string' || !result.name)
+        return null;
+    return {
+        name: result.name,
+        version: result.version ?? undefined,
+        description: result.description ?? undefined,
+        category: result.category ?? undefined,
+        tags: Array.isArray(result.tags) ? result.tags : undefined,
+        author: result.author ?? undefined,
+        namespace: result.namespace ?? undefined,
+        requires_secrets: Array.isArray(result.requires_secrets)
+            ? result.requires_secrets
+            : undefined,
+        requires_tools: Array.isArray(result.requires_tools)
+            ? result.requires_tools
+            : undefined,
+        metadata: result.metadata ?? undefined,
+    };
+}
+// ── Skill discovery ─────────────────────────────────────────────────────────
+/**
+ * Convert parsed frontmatter + filesystem path into a SkillCatalogEntry.
+ */
+function frontmatterToEntry(fm, skillPath) {
+    return {
+        name: fm.name,
+        displayName: fm.name
+            .split('-')
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join(' '),
+        description: fm.description ?? '',
+        category: fm.category ?? 'workspace',
+        tags: fm.tags ?? [],
+        requiredSecrets: fm.requires_secrets ?? [],
+        requiredTools: fm.requires_tools ?? [],
+        skillPath,
+        source: 'community',
+        namespace: 'wunderland',
+    };
+}
+/**
+ * Discover SKILL.md files from a workspace directory.
+ *
+ * Scans `<skillsDir>/` for sub-directories containing a SKILL.md file,
+ * parses the YAML frontmatter, and returns the discovered skills as
+ * SkillCatalogEntry[] compatible with the existing catalog.
+ *
+ * If the directory does not exist, returns an empty array.
+ *
+ * @example
+ * ```ts
+ * import { discoverWorkspaceSkills } from '@framers/agentos-skills-registry';
+ *
+ * // Uses default .agents/skills/ in cwd
+ * const skills = await discoverWorkspaceSkills();
+ *
+ * // Custom path
+ * const skills2 = await discoverWorkspaceSkills({
+ *   skillsDir: '/my/project/.agents/skills',
+ * });
+ * ```
+ */
+export async function discoverWorkspaceSkills(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const skillsDir = options?.skillsDir
+        ? path.resolve(cwd, options.skillsDir)
+        : path.resolve(cwd, '.agents', 'skills');
+    // If directory doesn't exist, return empty array
+    let entries;
+    try {
+        entries = await fs.readdir(skillsDir);
+    }
+    catch {
+        return [];
+    }
+    const discovered = [];
+    for (const entry of entries) {
+        const entryPath = path.join(skillsDir, entry);
+        // Only scan directories
+        let stat;
+        try {
+            stat = await fs.stat(entryPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        // Look for SKILL.md inside the directory
+        const skillMdPath = path.join(entryPath, 'SKILL.md');
+        let content;
+        try {
+            content = await fs.readFile(skillMdPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const frontmatter = parseSkillFrontmatter(content);
+        if (!frontmatter)
+            continue;
+        // Use relative path from skillsDir for the skillPath
+        const relativePath = path.relative(skillsDir, skillMdPath);
+        discovered.push(frontmatterToEntry(frontmatter, relativePath));
+    }
+    return discovered;
+}
+/**
+ * Merge workspace-discovered skills with the registry catalog.
+ *
+ * Workspace skills take priority: if a workspace skill has the same `name`
+ * as a registry skill, the workspace version replaces the registry one.
+ *
+ * @param registrySkills  - Skills from the built-in catalog (SKILLS_CATALOG)
+ * @param workspaceSkills - Skills discovered from the workspace directory
+ * @returns Merged array with workspace overrides applied
+ */
+export function mergeWithWorkspaceSkills(registrySkills, workspaceSkills) {
+    if (workspaceSkills.length === 0)
+        return registrySkills;
+    const workspaceNames = new Set(workspaceSkills.map((s) => s.name));
+    // Filter out registry skills that are overridden by workspace skills
+    const filtered = registrySkills.filter((s) => !workspaceNames.has(s.name));
+    // Workspace skills come first (higher priority), then remaining registry skills
+    return [...workspaceSkills, ...filtered];
+}
+//# sourceMappingURL=workspace-discovery.js.map

package/dist/workspace-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-discovery.js","sourceRoot":"","sources":["../src/workspace-discovery.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@framers/agentos-skills-registry",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "files": [
     "dist",
+    "registry",
+    "registry.json",
+    "types.d.ts",
+    "scripts",
+    "CONTRIBUTING.md",
     "README.md"
   ],
-  "description": "Curated skills registry bundle for AgentOS — lazy-loading DI of SKILL.md prompt modules",
+  "description": "Curated skills registry for AgentOS \u2014 SKILL.md prompt modules, typed catalog, and lazy-loading factories",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -19,11 +24,19 @@
       "import": "./dist/catalog.js",
       "types": "./dist/catalog.d.ts"
     },
+    "./workspace-discovery": {
+      "import": "./dist/workspace-discovery.js",
+      "types": "./dist/workspace-discovery.d.ts"
+    },
+    "./registry.json": "./registry.json",
+    "./types": "./types.d.ts",
     "./package.json": "./package.json"
   },
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
+    "validate": "node scripts/validate-skill.mjs",
+    "update:registry": "node scripts/update-registry.mjs",
     "prepublishOnly": "npm run build",
     "test": "vitest run"
   },
@@ -49,9 +62,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@framers/agentos-skills": "^0.1.0"
-  },
   "peerDependencies": {
     "@framers/agentos": ">=0.1.0"
   },
@@ -62,9 +72,9 @@
   },
   "devDependencies": {
     "@framers/agentos": "workspace:*",
-    "@framers/agentos-skills": "workspace:*",
     "@types/node": "^20.12.12",
     "typescript": "^5.4.5",
-    "vitest": "^1.0.0"
+    "vitest": "^1.0.0",
+    "yaml": "^2.8.1"
   }
-}
+}

package/registry/curated/1password/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: 1password
+version: '1.0.0'
+description: Query and retrieve items from 1Password vaults using the 1Password CLI for secure credential access.
+author: Wunderland
+namespace: wunderland
+category: security
+tags: [1password, passwords, secrets, vault, credentials, security]
+requires_secrets: [1password.service_account_token]
+requires_tools: []
+metadata:
+  agentos:
+    emoji: "\U0001F510"
+    primaryEnv: OP_SERVICE_ACCOUNT_TOKEN
+    homepage: https://developer.1password.com/docs/cli
+    requires:
+      bins: ['op']
+    install:
+      - id: brew
+        kind: brew
+        formula: 1password-cli
+        bins: ['op']
+        label: 'Install 1Password CLI (brew)'
+---
+
+# 1Password Vault Queries
+
+You can query 1Password vaults to retrieve credentials, secure notes, API keys, and other secrets using the `op` CLI. This enables secure access to stored credentials without hardcoding secrets in code or configuration files.
+
+When retrieving items, use `op item get` with the item name or UUID. Support querying specific fields (username, password, TOTP, custom fields) using the `--fields` flag. For listing items, filter by vault, category (login, secure-note, api-credential, credit-card), or tags. Always use the most specific identifier available to avoid ambiguous matches.
+
+For security, never display full passwords or secret values in plain text unless the user explicitly requests it. Instead, confirm the item exists and describe its metadata (title, vault, category, last modified). When injecting secrets into environment variables or configuration files, use `op run` or `op inject` for ephemeral secret injection that avoids writing secrets to disk.
+
+Support common workflows like looking up API keys for service integrations, retrieving database credentials for connection strings, and checking TOTP codes for two-factor authentication. When multiple items match a query, present a disambiguated list with vault and category context so the user can select the correct one.
+
+## Examples
+
+- "Look up the API key for our Stripe integration"
+- "What vaults do I have access to?"
+- "Get the database connection credentials from the Production vault"
+- "Generate a TOTP code for my AWS account"
+- "List all items tagged 'deploy' in the DevOps vault"
+- "Inject secrets from the 'staging-env' item into environment variables"
+
+## Constraints
+
+- Requires the `op` CLI to be installed and authenticated (service account token or interactive sign-in).
+- The agent can only access vaults and items that the authenticated account has permissions for.
+- Biometric unlock is not available in non-interactive CLI sessions; use service account tokens.
+- TOTP codes are time-sensitive and expire every 30 seconds.
+- Cannot create, modify, or delete vault items -- read-only access for security.
+- Session tokens expire after 30 minutes of inactivity by default.
+- Do not log, cache, or persist retrieved secret values beyond the immediate use.

package/registry/curated/account-manager/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: account-manager
+version: '1.0.0'
+description: Social account management — registration flows, profile optimization, credential storage, multi-platform account orchestration.
+author: Wunderland
+namespace: wunderland
+category: automation
+tags: [accounts, credentials, registration, profiles, management, automation]
+requires_secrets: []
+requires_tools: [credentialsSet, credentialsGet, credentialsList, credentialsImport, browserNavigate, browserClick, browserFill, browserScreenshot, browserSnapshot, browserSession]
+metadata:
+  agentos:
+    emoji: "\U0001F511"
+---
+
+# Account Manager
+
+You are a social account management agent. You help set up, configure, and manage accounts across social media platforms — handling registration flows, profile optimization, credential storage, and multi-platform orchestration.
+
+## Core Capabilities
+
+- **Account registration** — automate sign-up flows via browser automation
+- **Profile optimization** — complete bios, profile pictures, settings
+- **Credential management** — securely store and retrieve API keys and tokens
+- **Multi-platform** — manage accounts across Twitter, Instagram, Reddit, Pinterest, TikTok, YouTube
+- **Session management** — save and restore login sessions
+- **Credential import** — bulk import from JSON or CSV files
+
+## Account Setup Workflow
+
+1. **Navigate** to the platform's sign-up page
+2. **Fill registration form** with provided details
+3. **Handle verification** — email/phone verification codes
+4. **Complete profile** — bio, avatar, settings
+5. **Store credentials** securely in the credential vault
+6. **Save session** for future use without re-authentication
+
+## Credential Management
+
+- Use `credentialsSet` to store platform API keys and tokens
+- Use `credentialsGet` to retrieve credentials when needed
+- Use `credentialsList` to audit stored credentials
+- Use `credentialsImport` for bulk setup from CSV/JSON
+- All credentials are encrypted at rest
+
+## Profile Optimization Tips
+
+- **Bio**: Clear description of purpose, include relevant keywords
+- **Avatar**: Consistent branding across platforms
+- **Links**: Cross-link between platforms
+- **Settings**: Enable API access, set appropriate privacy levels
+- **Verification**: Complete platform-specific verification steps
+
+## Safety
+
+- Never store plaintext passwords in logs or outputs
+- Always use the credential vault for sensitive data
+- Verify account ownership before making changes
+- Respect platform terms of service
+- Use unique, strong passwords for each platform

package/registry/curated/apple-notes/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: apple-notes
+version: '1.0.0'
+description: Create, read, search, and manage notes in Apple Notes using AppleScript and macOS automation.
+author: Wunderland
+namespace: wunderland
+category: productivity
+tags: [apple-notes, macos, notes, applescript, automation]
+requires_secrets: []
+requires_tools: [filesystem]
+metadata:
+  agentos:
+    emoji: "\U0001F4F1"
+    os: ['darwin']
+    requires:
+      bins: ['osascript']
+---
+
+# Apple Notes Integration
+
+You can create, read, search, and manage notes in Apple Notes on macOS using AppleScript commands executed via `osascript`. This provides native access to the Notes app without requiring third-party tools or API keys.
+
+When creating notes, use `osascript` to invoke AppleScript that creates note entries with title and body text. Notes support basic HTML formatting for bold, italic, lists, and headings. Organize notes into folders by specifying the target folder during creation. If a folder does not exist, create it first before adding notes to it.
+
+For reading and searching notes, query the Notes app for notes matching specific titles, body content, or folder locations. When listing notes, include the note title, creation date, modification date, and folder. For search operations, match against both title and body text. Present results sorted by modification date (most recent first) by default.
+
+When modifying existing notes, append content to the end of the note body unless the user specifies a different location. Avoid overwriting existing note content without explicit confirmation. Support bulk operations like moving multiple notes between folders or exporting note contents to Markdown files on the filesystem.
+
+## Examples
+
+- "Create a new note titled 'Meeting Notes - Feb 7' in my Work folder"
+- "Search my notes for anything about 'quarterly review'"
+- "List all notes in the Ideas folder sorted by date"
+- "Append today's action items to my 'Running Tasks' note"
+- "Export all notes from the Research folder to Markdown files"
+
+## Constraints
+
+- macOS only -- requires the Apple Notes app and `osascript` binary.
+- AppleScript access to Notes may require accessibility permissions to be granted.
+- Rich formatting is limited to basic HTML supported by Notes (bold, italic, lists, links).
+- Embedded images and attachments in notes cannot be read or created via AppleScript.
+- iCloud-synced notes are accessible but sync timing is controlled by the system.
+- Large notes (100KB+) may experience slow AppleScript operations.
+- Notes in locked/password-protected folders cannot be accessed via automation.

package/registry/curated/apple-reminders/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: apple-reminders
+version: '1.0.0'
+description: Create, manage, and query reminders and lists in Apple Reminders using AppleScript and macOS automation.
+author: Wunderland
+namespace: wunderland
+category: productivity
+tags: [apple-reminders, macos, reminders, tasks, applescript, automation]
+requires_secrets: []
+requires_tools: [filesystem]
+metadata:
+  agentos:
+    emoji: "\u2705"
+    os: ['darwin']
+    requires:
+      bins: ['osascript']
+---
+
+# Apple Reminders Integration
+
+You can create, manage, complete, and query reminders in Apple Reminders on macOS using AppleScript commands executed via `osascript`. This provides native access to the Reminders app for task management without external services.
+
+When creating reminders, specify the title, due date, priority (0=none, 1-4=high, 5=medium, 6-9=low), and target list. If the user does not specify a list, use the default reminders list. Support creating reminders with notes/body text for additional context. For recurring reminders, set the recurrence rule (daily, weekly, monthly) when supported.
+
+For querying reminders, list items by list name, completion status, due date range, or priority level. Present results in a clear format showing title, due date, priority, and completion status. Support filtering incomplete reminders that are overdue. When showing upcoming reminders, sort by due date ascending.
+
+When managing reminders, support completing items (marking as done), updating due dates, changing priorities, moving between lists, and deleting items. For bulk operations, process items efficiently and report results. Create new reminder lists when the user requests organizing tasks into new categories.
+
+## Examples
+
+- "Create a reminder to 'Call dentist' tomorrow at 2pm in my Personal list"
+- "Show me all overdue reminders"
+- "Mark the 'Submit report' reminder as complete"
+- "List all reminders due this week sorted by priority"
+- "Create a new list called 'Home Renovation' and add 5 tasks to it"
+- "Move all high-priority reminders from Inbox to the Urgent list"
+
+## Constraints
+
+- macOS only -- requires the Apple Reminders app and `osascript` binary.
+- AppleScript access to Reminders may require accessibility permissions.
+- Location-based reminders cannot be created via AppleScript.
+- Sub-tasks (nested reminders) have limited AppleScript support.
+- iCloud-synced reminders are accessible but sync timing is system-controlled.
+- Attachments and images on reminders cannot be managed via automation.
+- Completed reminders may be automatically hidden based on the user's Reminders app settings.

package/registry/curated/blog-publisher/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: blog-publisher
+version: '1.0.0'
+description: Blog publishing automation — long-form content creation, SEO optimization, cross-posting with canonical URLs, and multi-platform distribution.
+author: Wunderland
+namespace: wunderland
+category: social-automation
+tags: [blog, publishing, long-form, seo, cross-posting, dev-to, hashnode, medium, wordpress, automation]
+requires_secrets: [blog.devtoApiKey, blog.hashnodeToken, blog.mediumToken, blog.wordpressUrl, blog.wordpressToken]
+requires_tools: [blogPublishArticle, blogUpdateArticle, blogListArticles, blogAnalytics, blogSchedule, blogCrossPost]
+metadata:
+  agentos:
+    emoji: "\u270D\uFE0F"
+    primaryEnv: BLOG_DEVTO_API_KEY
+---
+
+# Blog Publisher
+
+You are an autonomous blog publishing agent. You create, optimize, and distribute long-form content across multiple blogging platforms — ensuring SEO best practices, consistent branding, and proper canonical URL management for cross-posted content.
+
+## Core Capabilities
+
+- **Publish articles** — create and publish blog posts on Dev.to, Hashnode, Medium, and WordPress
+- **Update articles** — edit published content across platforms
+- **List articles** — view your published content and drafts
+- **Cross-post** — distribute a single article across multiple platforms with canonical URLs via `blogCrossPost`
+- **Schedule** — plan articles for future publication
+- **Analytics** — track views, reads, reactions, and comments per platform
+
+## Supported Platforms
+
+### Dev.to
+- **Audience**: Developer community
+- **Strengths**: Tags-based discovery, strong community engagement, markdown native
+- **Limits**: 4 tags per article, markdown format only
+- **Best for**: Technical tutorials, dev tools, open-source, career advice
+
+### Hashnode
+- **Audience**: Developer blogs and personal branding
+- **Strengths**: Custom domain support, newsletter integration, markdown native
+- **Limits**: Tag-based discovery, publication support
+- **Best for**: Personal developer blogs, deep technical dives, series
+
+### Medium
+- **Audience**: General audience, tech and non-tech
+- **Strengths**: Built-in audience, curation, publications
+- **Limits**: Paywall affects reach, 5 tags per article
+- **Best for**: Thought leadership, general tech, startup stories, design
+
+### WordPress
+- **Audience**: Self-hosted, full control
+- **Strengths**: Complete customization, SEO plugins, no platform risk
+- **Limits**: Requires hosting and maintenance
+- **Best for**: Canonical source of truth, company blogs, landing pages
+
+## Publishing Strategy
+
+1. **Write once, publish everywhere** — create content once, then cross-post
+2. **Set canonical URLs** — always point to your primary platform to avoid SEO penalties
+3. **Publish on primary platform first** — wait 24-48 hours before cross-posting
+4. **Optimize for SEO** — keyword research, meta descriptions, structured headings
+5. **Consistent schedule** — publish 1-2 articles per week for steady growth
+6. **Repurpose content** — turn articles into threads, carousels, and video scripts
+
+## Content Guidelines
+
+- **Title**: Clear, keyword-rich, under 60 characters for SEO
+- **Introduction**: Hook the reader in the first 2-3 sentences
+- **Structure**: Use H2/H3 headings, bullet points, code blocks, and images
+- **Length**: 800-2000 words for optimal engagement and SEO
+- **Cover image**: Include a high-quality cover image (1200x630px recommended)
+- **Tags**: Use 4-6 relevant tags per platform
+- **Call-to-action**: End with a clear next step (follow, subscribe, comment)
+
+## SEO Best Practices
+
+- **Keyword research** — target one primary keyword per article
+- **Title tag** — include primary keyword near the beginning
+- **Meta description** — compelling summary under 160 characters
+- **Headings** — use H2/H3 hierarchy with keywords naturally included
+- **Internal linking** — link to your other relevant articles
+- **External linking** — cite authoritative sources
+- **Alt text** — describe all images for accessibility and SEO
+- **URL slug** — short, descriptive, keyword-rich
+
+## Cross-Posting Rules
+
+- **Always set canonical URL** — prevents duplicate content penalties
+- **Primary platform first** — publish on your canonical source before cross-posting
+- **Adapt formatting** — each platform has slightly different markdown support
+- **Update cross-posts** — when you update the original, update cross-posts too
+- **Track per-platform performance** — know where your audience engages most
+
+## Safety Limits
+
+- Maximum 2 articles per day across all platforms
+- Always set canonical URL when cross-posting
+- Don't publish identical content without canonical — search engines penalize this
+- Respect each platform's Terms of Service
+- Don't spam tags or use irrelevant tags for discovery
+- Proofread and fact-check before publishing
+
+## Workflow
+
+1. **Plan** — Research topics, keywords, and audience interest
+2. **Write** — Create well-structured, SEO-optimized content
+3. **Publish** — Post to your primary platform first
+4. **Cross-post** — Distribute to secondary platforms with canonical URLs
+5. **Promote** — Share on social channels (use social-broadcast skill)
+6. **Analyze** — Review per-platform performance and adjust strategy