@framers/agentos-skills 0.3.0 → 0.4.1

package/CONTRIBUTING.md

@@ -0,0 +1,231 @@
+# Contributing to @framers/agentos-skills
+
+Thank you for your interest in contributing a skill to the AgentOS ecosystem! This guide walks you through the process of creating, testing, and submitting a new skill.
+
+## Overview
+
+Skills are **SKILL.md files** — each containing YAML frontmatter (metadata) and a markdown body (instructions for the AI agent). They live inside the `@framers/agentos-skills` content package under `registry/`. The typed SDK that discovers and loads them lives in the sibling `@framers/agentos-skills-registry` package. There are no individual packages per skill.
+
+Skills are organized into two tiers:
+
+| Tier          | Directory             | Namespace    | Maintained By               | Verified |
+| ------------- | --------------------- | ------------ | --------------------------- | -------- |
+| **Curated**   | `registry/curated/`   | `wunderland` | Framers staff               | Yes      |
+| **Community** | `registry/community/` | `community`  | Original author / community | No       |
+
+Curated skills ship pre-verified and are maintained by the Framers team. Community skills are submitted via pull request by anyone and are maintained by their authors.
+
+## Creating a New Skill
+
+### Step 1 — Fork the repo
+
+Fork [framersai/agentos-skills-registry](https://github.com/framersai/agentos-skills-registry) and clone it locally.
+
+```bash
+git clone https://github.com/<your-username>/agentos-skills-registry.git
+cd agentos-skills-registry
+```
+
+### Step 2 — Create the skill directory
+
+Create a new directory under `registry/community/` with your skill name. The directory name must be lowercase, use hyphens for separators, and match the `name` field in your frontmatter.
+
+```bash
+mkdir -p registry/community/my-skill
+```
+
+### Step 3 — Write the SKILL.md file
+
+Create `registry/community/my-skill/SKILL.md` with two parts:
+
+1. **YAML frontmatter** between `---` delimiters containing metadata
+2. **Markdown body** containing instructions for the AI agent
+
+The markdown body should be written in **2nd person** ("You can...", "Use the...") because it is injected directly into an agent's system prompt.
+
+### Step 4 — Write the YAML frontmatter
+
+Fill in all required fields. See the [SKILL.md Format Reference](#skillmd-format-reference) below for the complete spec.
+
+### Step 5 — Write the markdown body
+
+The body is the actual instructions the AI agent will follow. It should include:
+
+- A heading with the skill name
+- A description of what the skill enables the agent to do
+- Step-by-step guidance for how the agent should use the skill
+- An **Examples** section with concrete usage examples
+- A **Constraints** section documenting limitations
+
+### Step 6 — Validate your skill
+
+```bash
+npm run validate registry/community/my-skill/SKILL.md
+```
+
+## SKILL.md Format Reference
+
+### Required Fields
+
+| Field         | Type   | Description                                                                |
+| ------------- | ------ | -------------------------------------------------------------------------- |
+| `name`        | string | Skill identifier. Must match the directory name. Lowercase, hyphens only.  |
+| `version`     | string | Semantic version (e.g., `'1.0.0'`). Quote it to avoid YAML parsing issues. |
+| `description` | string | Short description, under 200 characters.                                   |
+| `author`      | string | Your name or GitHub username.                                              |
+| `namespace`   | string | Must be `community` for community submissions.                             |
+| `category`    | string | One of the valid categories listed below.                                  |
+| `tags`        | array  | At least one tag. Use lowercase, hyphenated strings.                       |
+
+### Optional Fields
+
+| Field                       | Type   | Description                                                               |
+| --------------------------- | ------ | ------------------------------------------------------------------------- |
+| `requires_secrets`          | array  | Secret keys the skill needs (e.g., `[service.token]`). Use `[]` if none.  |
+| `requires_tools`            | array  | Tool names the skill depends on (e.g., `[web-search]`). Use `[]` if none. |
+| `metadata.agentos.emoji`    | string | Emoji icon for the skill in UIs.                                          |
+| `metadata.agentos.homepage` | string | URL to the skill's related service or docs.                               |
+
+### Valid Categories
+
+- `automation` — Workflow automation, orchestration, repetitive task handling
+- `communication` — Chat, email, messaging platforms
+- `content` — Content planning, drafting, publishing pipelines
+- `creative` — Art, writing, design, generation
+- `developer-tools` — Code, repos, CI/CD, debugging
+- `devops` — Operational tooling, monitoring, reliability checks
+- `information` — Data lookup, search, knowledge retrieval
+- `infrastructure` — Infrastructure provisioning, hosting, deployment workflows
+- `marketing` — SEO, campaigns, growth workflows
+- `media` — Audio, video, image, streaming
+- `productivity` — Note-taking, task management, organization
+- `research` — Multi-source investigation and synthesis
+- `security` — Passwords, encryption, access control
+- `social-automation` — Social publishing, engagement, and channel management
+
+### Full Template
+
+Copy and paste this into `registry/community/<your-skill>/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+version: '1.0.0'
+description: A short description of what this skill does (under 200 characters).
+author: your-github-username
+namespace: community
+category: information
+tags: [example, template]
+requires_secrets: []
+requires_tools: []
+metadata:
+  agentos:
+    emoji: "\U0001F527"
+    homepage: https://example.com
+---
+
+# My Skill
+
+You can use this skill to [describe what the agent can do]. When the user asks about [topic], you should [describe the agent's behavior].
+
+Provide clear, structured responses. If the user's request is ambiguous, ask for clarification before proceeding.
+
+## Examples
+
+- "Example user query 1"
+- "Example user query 2"
+- "Example user query 3"
+
+## Constraints
+
+- Limitation or caveat 1.
+- Limitation or caveat 2.
+- Limitation or caveat 3.
+```
+
+## Testing Your Skill
+
+Run the validation script against your SKILL.md file:
+
+```bash
+npm run validate registry/community/my-skill/SKILL.md
+```
+
+The validator checks:
+
+- All required frontmatter fields are present
+- Category is valid
+- Description is under 200 characters
+- Tags array has at least one entry
+- Namespace is `community` or `wunderland`
+- Skill name matches the directory name
+- Markdown body is not empty
+- No obvious secrets or API keys are embedded in the file
+
+Fix any reported issues before submitting your PR.
+
+## Submitting a PR
+
+### 1. Create a branch
+
+```bash
+git checkout -b add-skill/my-skill
+```
+
+### 2. Commit your SKILL.md
+
+```bash
+git add registry/community/my-skill/SKILL.md
+git commit -m "feat: add my-skill community skill"
+```
+
+### 3. Push and open a PR
+
+```bash
+git push origin add-skill/my-skill
+```
+
+Open a pull request against the `main` branch. The PR template will guide you through the checklist.
+
+### PR Checklist
+
+Before submitting, confirm:
+
+- [ ] Skill is in `registry/community/<name>/SKILL.md`
+- [ ] All required YAML fields are present
+- [ ] `namespace` is set to `community`
+- [ ] Category is one of the 8 valid categories
+- [ ] Description is under 200 characters
+- [ ] Markdown body includes usage instructions, Examples, and Constraints
+- [ ] No secrets, API keys, or credentials are in the file
+- [ ] `npm run validate` passes
+
+### What Reviewers Look For
+
+- **Quality**: Is the skill well-written? Are instructions clear and actionable?
+- **No secrets**: The file must not contain API keys, tokens, passwords, or credentials.
+- **Valid format**: Frontmatter must parse correctly with all required fields.
+- **Usefulness**: Does the skill provide value that is not already covered by an existing skill?
+- **Specificity**: Is the scope well-defined? Skills should do one thing well.
+
+## Promotion to Curated
+
+Community skills can be promoted to the curated tier. Promotion criteria:
+
+1. **Longevity** — The skill has been in `registry/community/` for at least 3 months.
+2. **Positive feedback** — The skill has received positive user feedback or adoption.
+3. **Maintained** — The original author is responsive to issues and keeps the skill up to date.
+4. **Staff review** — A Framers team member reviews the skill for quality and completeness.
+
+When a skill is promoted:
+
+- It moves from `registry/community/<name>/` to `registry/curated/<name>/`.
+- The `namespace` field changes from `community` to `wunderland`.
+- The `verified` flag is set to `true` in `registry.json`.
+- The Framers team assumes co-maintenance responsibility.
+
+To nominate a community skill for promotion, open an issue titled "Promote: <skill-name>" with a brief justification.
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/). By participating, you agree to uphold this code. Please report unacceptable behavior to [team@frame.dev](mailto:team@frame.dev).

package/README.md

@@ -6,7 +6,7 @@
 
 # @framers/agentos-skills
 
-Skills runtime for the [AgentOS](https://github.com/framersai/agentos) ecosystem -- loads, parses, and manages SKILL.md prompt modules.
+**Curated SKILL.md prompt modules for AgentOS** — 72 staff-verified skills with a machine-readable registry index.
 
 [![npm](https://img.shields.io/npm/v/@framers/agentos-skills?logo=npm&color=cb3837)](https://www.npmjs.com/package/@framers/agentos-skills)
 
@@ -14,83 +14,118 @@ Skills runtime for the [AgentOS](https://github.com/framersai/agentos) ecosystem
 npm install @framers/agentos-skills
 ```
 
-## What's Inside
+> **This is the content package.** It contains 72 curated SKILL.md files and
+> the auto-generated `registry.json` index — no runtime code, no dependencies.
+>
+> For the **catalog SDK** (query helpers, lazy loading, factory functions), see
+> [`@framers/agentos-skills-registry`](https://github.com/framersai/agentos-skills-registry).
+>
+> For the **runtime engine** (SkillLoader, SkillRegistry, path utilities), see
+> [`@framers/agentos`](https://github.com/framersai/agentos) (`@framers/agentos/skills`).
 
-This package is the **runtime** for the AgentOS skills system. It provides:
+## What's Inside
 
-| Module              | Description                                                              |
-| ------------------- | ------------------------------------------------------------------------ |
-| `SkillLoader`       | Loads and parses SKILL.md files with YAML frontmatter                    |
-| `SkillRegistry`     | Runtime registry for managing, querying, and filtering loaded skills     |
-| `paths`             | Path resolution utilities for discovering default skill directories      |
-| `types`             | Full TypeScript type definitions for skills, metadata, and configuration |
+This package bundles **72 curated SKILL.md files** organized under `registry/curated/`:
+
+| Category       | Skills                                                                 |
+| -------------- | ---------------------------------------------------------------------- |
+| Developer      | `github`, `git`, `coding-agent`, `code-safety`, `structured-output`    |
+| Social         | `twitter-bot`, `instagram-bot`, `linkedin-bot`, `facebook-bot`, `threads-bot`, `bluesky-bot`, `mastodon-bot`, `youtube-bot`, `tiktok-bot`, `pinterest-bot`, `reddit-bot`, `blog-publisher`, `social-broadcast` |
+| Research       | `web-search`, `web-scraper`, `deep-research`, `summarize`, `company-research` |
+| Productivity   | `notion`, `obsidian`, `trello`, `apple-notes`, `apple-reminders`, `spotify-player` |
+| Communication  | `slack-helper`, `discord-helper`, `email-intelligence`                 |
+| Voice          | `voice-conversation`, `whisper-transcribe`, `streaming-stt-*`, `streaming-tts-*`, `vosk`, `piper`, `porcupine`, `openwakeword`, `diarization` |
+| Creative       | `image-gen`, `image-editing`, `audio-generation`, `video-generation`, `content-creator` |
+| AI/ML          | `vision-ocr`, `multimodal-rag`, `ml-content-classifier`, `endpoint-semantic`, `grounding-guard`, `topicality`, `emergent-tools`, `pii-redaction` |
+| Infrastructure | `cloud-ops`, `site-deploy`, `healthcheck`                              |
+| Security       | `1password`                                                            |
+| Other          | `memory-manager`, `account-manager`, `agent-config`, `seo-campaign`, `weather` |
+
+Each skill is a Markdown file with YAML frontmatter:
+
+```yaml
+---
+name: github
+version: '2.0.0'
+description: Full GitHub API integration
+author: Wunderland
+category: developer
+tags: [github, git, repository]
+requires_secrets: [github.token]
+requires_tools: [github_search, github_repo_list]
+metadata:
+  agentos:
+    emoji: "🐙"
+    primaryEnv: GITHUB_TOKEN
+    requires:
+      bins: ['gh']
+    install:
+      - id: brew-gh
+        kind: brew
+        formula: gh
+        bins: [gh]
+---
+
+# GitHub
+
+[Markdown instructions for the agent...]
+```
 
-## Usage
+## Ecosystem
 
-```typescript
-import {
-  SkillRegistry,
-  loadSkillFromDir,
-  loadSkillsFromDir,
-  resolveDefaultSkillsDirs,
-} from '@framers/agentos-skills';
+```
+@framers/agentos/skills               ← Engine (SkillLoader, SkillRegistry, path utils)
+@framers/agentos-skills               ← Content (you are here — 72 SKILL.md files + registry.json)
+@framers/agentos-skills-registry      ← Catalog SDK (SKILLS_CATALOG, query helpers, factories)
+```
 
-// Discover default skill directories
-const dirs = resolveDefaultSkillsDirs();
+| Package                              | Role            | What                                                    | Runtime Code |
+| ------------------------------------ | --------------- | ------------------------------------------------------- | :----------: |
+| **@framers/agentos/skills**          | **Engine**      | SkillLoader, SkillRegistry, path utils                  |     Yes      |
+| **@framers/agentos-skills**          | **Content**     | 72 SKILL.md files + registry.json index                 |      No      |
+| **@framers/agentos-skills-registry** | **Catalog SDK** | SKILLS_CATALOG, query helpers, lazy loaders, factories  |     Yes      |
 
-// Create a registry and load skills
-const registry = new SkillRegistry();
-await registry.loadFromDirs(dirs);
+> This layout mirrors the extensions ecosystem:
+> `@framers/agentos-extensions` (content) + `@framers/agentos-extensions-registry` (SDK).
 
-console.log(`Loaded ${registry.size} skills`);
+## Usage
 
-// Build a snapshot for LLM context
-const snapshot = registry.buildSnapshot({ platform: 'darwin', strict: true });
-console.log(snapshot.prompt);
-```
+### Direct JSON import
 
-## Relationship to Other Packages
+```typescript
+import registry from '@framers/agentos-skills/registry.json';
 
-```
-@framers/agentos-skills              <-- You are here (runtime: SkillLoader, SkillRegistry, types)
-@framers/agentos-skills-registry     (catalog: 40+ curated SKILL.md files + JSON index)
-@framers/agentos                     (full cognitive runtime, re-exports skills from here)
+console.log(`${registry.stats.totalSkills} skills available`);
+for (const skill of registry.skills.curated) {
+  console.log(`  ${skill.metadata?.emoji ?? '📦'} ${skill.name} — ${skill.description}`);
+}
 ```
 
-| Package                              | What                                      | Runtime Code | Dependencies    |
-| ------------------------------------ | ----------------------------------------- | :----------: | --------------- |
-| **@framers/agentos-skills**          | SkillLoader, SkillRegistry, path utils    |     Yes      | `yaml`          |
-| **@framers/agentos-skills-registry** | 40+ SKILL.md files + JSON index + catalog |      No      | `yaml`          |
-| **@framers/agentos**                 | Full cognitive runtime                    |     Yes      | Many            |
+### Via the catalog SDK (recommended)
 
-## API
+```typescript
+import { searchSkills, loadSkillByName } from '@framers/agentos-skills-registry';
 
-### SkillLoader
+const matches = searchSkills('github');
+const skill = await loadSkillByName('github');
+console.log(skill?.content); // SKILL.md body ready for prompt injection
+```
 
-- `parseSkillFrontmatter(content)` -- Parse YAML frontmatter from SKILL.md content
-- `extractMetadata(frontmatter)` -- Extract typed SkillMetadata from parsed frontmatter
-- `loadSkillFromDir(dir)` -- Load a single skill from a directory containing SKILL.md
-- `loadSkillsFromDir(dir)` -- Load all skills from a parent directory
-- `filterByPlatform(entries, platform)` -- Filter skill entries by OS platform
-- `filterByEligibility(entries, context)` -- Filter by full eligibility context
-- `checkBinaryRequirements(entry, hasBin)` -- Check if binary requirements are met
+### Via the runtime engine
 
-### SkillRegistry
+```typescript
+import { SkillRegistry } from '@framers/agentos/skills';
 
-- `register(entry)` / `unregister(name)` -- Add/remove skills
-- `loadFromDir(dir)` / `loadFromDirs(dirs)` / `reload(options)` -- Bulk loading
-- `getByName(name)` / `listAll()` / `has(name)` / `size` -- Queries
-- `filterByPlatform(platform)` / `filterByEligibility(context)` -- Filtering
-- `getUserInvocableSkills()` / `getModelInvocableSkills()` -- Invocation filtering
-- `buildSnapshot(options)` -- Build LLM context snapshot
-- `buildPrompt(entries)` -- Format skills into prompt text
-- `buildCommandSpecs(options)` -- Generate CLI command specs
+const registry = new SkillRegistry();
+await registry.loadFromDirs(['/path/to/agentos-skills/registry/curated']);
+const snapshot = registry.buildSnapshot({ platform: 'darwin', strict: true });
+console.log(snapshot.prompt);
+```
 
-### Path Utilities
+## Contributing
 
-- `resolveDefaultSkillsDirs(options)` -- Resolve default skill directories to scan
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on adding new skills.
 
 ## License
 
 MIT
-

package/package.json

@@ -1,34 +1,37 @@
 {
   "name": "@framers/agentos-skills",
-  "version": "0.3.0",
-  "description": "Skills runtime for AgentOS — loads, parses, and manages SKILL.md prompt modules",
+  "version": "0.4.1",
+  "description": "Curated SKILL.md prompt modules for AgentOS — 72 staff-verified skills with machine-readable registry index",
   "type": "module",
   "sideEffects": false,
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
+    ".": "./registry.json",
+    "./registry.json": "./registry.json",
+    "./types": "./types.d.ts",
     "./package.json": "./package.json"
   },
   "files": [
-    "dist",
+    "registry",
+    "registry.json",
+    "types.d.ts",
+    "scripts",
+    "CONTRIBUTING.md",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "clean": "rm -rf dist *.tsbuildinfo"
+    "validate": "node scripts/validate-skill.mjs",
+    "update:registry": "node scripts/update-registry.mjs",
+    "typecheck": "echo 'agentos-skills: content-only package, no TypeScript to check'",
+    "build": "echo 'agentos-skills: content-only package, no build step'"
   },
   "keywords": [
     "agentos",
     "skills",
-    "runtime",
-    "skill-loader",
-    "skill-registry",
-    "prompts"
+    "prompts",
+    "skill-modules",
+    "ai-agent",
+    "prompt-engineering",
+    "curated-catalog"
   ],
   "author": {
     "name": "Framers AI",
@@ -42,20 +45,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "dependencies": {
-    "yaml": "^2.8.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.12.12",
-    "typescript": "^5.4.5"
-  },
-  "peerDependencies": {
-    "@framers/agentos": ">=0.1.0"
-  },
-  "peerDependenciesMeta": {
-    "@framers/agentos": {
-      "optional": true
-    }
   }
 }

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/agent-config/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: agent-config
+description: Export and import agent configurations for sharing and backup
+version: 1.0.0
+tags: [agent, config, export, import, yaml, json]
+tools_required: []
+---
+
+# Agent Configuration
+
+Export agent configurations as portable YAML/JSON files for sharing, backup, and migration. Import configurations to recreate agents.
+
+## Capabilities
+- **Export**: Save agent config with instructions, tools, personality, guardrails
+- **Import**: Recreate agent from exported config
+- **Secret redaction**: API keys automatically redacted on export
+- **Round-trip**: Export -> edit -> import workflow
+
+## Example
+"Export my research agent to a file"
+"Import this agent configuration"
+"Share my agent config with the team"