opencode-skills-collection 4.0.52 → 4.0.54

package/bundled-skills/docs/maintainers/skills-date-tracking.md

@@ -1,228 +0,0 @@
-# Skills Date Tracking Guide
-
-This guide explains how to use the new `date_added` feature for tracking when skills were created or added to the collection.
-
-## Overview
-
-The `date_added` field in skill frontmatter allows you to track when each skill was created. This is useful for:
-
-- **Versioning**: Understanding skill age and maturity
-- **Changelog generation**: Tracking new skills over time
-- **Reporting**: Analyzing skill collection growth
-- **Organization**: Grouping skills by creation date
-
-## Format
-
-The `date_added` field uses ISO 8601 date format: **YYYY-MM-DD**
-
-```yaml
----
-name: my-skill-name
-description: "Brief description"
-date_added: "2024-01-15"
----
-```
-
-## Quick Start
-
-### 1. View All Skills with Their Dates
-
-```bash
-python tools/scripts/manage_skill_dates.py list
-```
-
-Output example:
-```
-📅 Skills with Date Added (example):
-============================================================
-  2025-02-26  │  recent-skill
-  2025-02-20  │  another-new-skill
-  2024-12-15  │  older-skill
-  ...
-
-⏳ Skills without Date Added (example):
-============================================================
-  some-legacy-skill
-  undated-skill
-  ...
-
-📊 Coverage: example output only
-```
-
-### 2. Add Missing Dates
-
-Add today's date to all skills that don't have a `date_added` field:
-
-```bash
-python tools/scripts/manage_skill_dates.py add-missing
-```
-
-Or specify a custom date:
-
-```bash
-python tools/scripts/manage_skill_dates.py add-missing --date 2026-03-06
-```
-
-### 3. Add/Update All Skills
-
-Set a date for all skills at once:
-
-```bash
-python tools/scripts/manage_skill_dates.py add-all --date 2026-03-06
-```
-
-### 4. Update a Single Skill
-
-Update a specific skill's date:
-
-```bash
-python tools/scripts/manage_skill_dates.py update my-skill-name 2026-03-06
-```
-
-### 5. Generate a Report
-
-Generate a JSON report of all skills with their metadata:
-
-```bash
-python tools/scripts/generate_skills_report.py
-```
-
-Save to file:
-
-```bash
-python tools/scripts/generate_skills_report.py --output skills_report.json
-```
-
-Sort by name:
-
-```bash
-python tools/scripts/generate_skills_report.py --sort name --output sorted_skills.json
-```
-
-## Usage in Your Workflow
-
-### When Creating a New Skill
-
-Add the `date_added` field to your SKILL.md frontmatter:
-
-```yaml
----
-name: new-awesome-skill
-description: "Does something awesome"
-date_added: "2026-03-06"
----
-```
-
-### Automated Addition
-
-When onboarding many skills, use:
-
-```bash
-python tools/scripts/manage_skill_dates.py add-missing --date 2026-03-06
-```
-
-This adds today's date to all skills that are missing the field.
-
-### Validation
-
-The validators now check `date_added` format:
-
-```bash
-# Run the operational validator
-npm run validate
-
-# Optional hardening pass
-npm run validate:strict
-
-# Reference validation
-npm run validate:references
-
-# Run smoke tests
-npm test
-```
-
-These checks catch invalid dates, broken references, and related regressions.
-
-## Generated Reports
-
-The `generate_skills_report.py` script produces a JSON report with statistics:
-
-```json
-{
-  "generated_at": "2026-03-06T10:30:00.123456",
-  "total_skills": 1234,
-  "skills_with_dates": 1200,
-  "skills_without_dates": 34,
-  "coverage_percentage": 97.2,
-  "sorted_by": "date",
-  "skills": [
-    {
-      "id": "recent-skill",
-      "name": "recent-skill",
-      "description": "A newly added skill",
-      "date_added": "2026-03-06",
-      "source": "community",
-      "risk": "safe",
-      "category": "recent"
-    },
-    ...
-  ]
-}
-```
-
-Use this for:
-- Dashboard displays
-- Growth metrics
-- Automated reports
-- Analytics
-
-## Integration with CI/CD
-
-Add to your pipeline:
-
-```bash
-# In pre-commit or CI pipeline
-npm run validate
-npm run validate:references
-
-# Generate stats report
-python tools/scripts/generate_skills_report.py --output reports/skills_report.json
-```
-
-## Best Practices
-
-1. **Use consistent format**: Always use `YYYY-MM-DD`
-2. **Use real dates**: Reflect actual skill creation dates when possible
-3. **Update on creation**: Add the date when creating new skills
-4. **Validate regularly**: Run validators to catch format errors
-5. **Review reports**: Use generated reports to understand collection trends
-
-## Troubleshooting
-
-### "Invalid date_added format"
-
-Make sure the date is in `YYYY-MM-DD` format:
-- ✅ Correct: `2024-01-15`
-- ❌ Wrong: `01/15/2024` or `2024-1-15`
-
-### Script not found
-
-Make sure you're running from the project root:
-```bash
-cd path/to/agentic-awesome-skills
-python tools/scripts/manage_skill_dates.py list
-```
-
-### Python not found
-
-Install Python 3.x from [python.org](https://python.org/)
-
-## Related Documentation
-
-- [`../contributors/skill-anatomy.md`](../contributors/skill-anatomy.md) - Complete skill structure guide
-- [`skills-update-guide.md`](skills-update-guide.md) - How to update the skill collection
-- [`../contributors/examples.md`](../contributors/examples.md) - Example skills
-
-## Questions or Issues?
-
-See [CONTRIBUTING.md](../../CONTRIBUTING.md) for contribution guidelines.

package/bundled-skills/docs/maintainers/skills-import-2026-03-21.md

@@ -1,81 +0,0 @@
-# Skills Import - 2026-03-21
-
-This note records the skill import and normalization work completed on 2026-03-21.
-
-## Summary
-
-- Imported new skill directories from external repositories.
-- Normalized frontmatter for imported skills where needed.
-- Repaired imported dangling links that did not map cleanly into this repository.
-- Regenerated derived artifacts after import.
-
-## Imported Skills by Source
-
-### `anthropics/skills`
-
-- `claude-api`
-- `internal-comms`
-
-Note:
-- `docx`, `pdf`, `pptx`, and `xlsx` were not re-imported as separate directories because this repository already exposes those aliases as symlinks to `*-official` skill directories.
-
-### `coreyhaines31/marketingskills`
-
-- `ad-creative`
-- `ai-seo`
-- `churn-prevention`
-- `cold-email`
-- `content-strategy`
-- `lead-magnets`
-- `product-marketing-context`
-- `revops`
-- `sales-enablement`
-- `site-architecture`
-
-### `AgriciDaniel/claude-seo`
-
-- `seo`
-- `seo-competitor-pages`
-- `seo-content`
-- `seo-dataforseo`
-- `seo-geo`
-- `seo-hreflang`
-- `seo-image-gen`
-- `seo-images`
-- `seo-page`
-- `seo-plan`
-- `seo-programmatic`
-- `seo-schema`
-- `seo-sitemap`
-- `seo-technical`
-
-### `kepano/obsidian-skills`
-
-- `defuddle`
-- `json-canvas`
-- `obsidian-bases`
-- `obsidian-cli`
-- `obsidian-markdown`
-
-## Not Imported
-
-These repositories were analyzed earlier in the comparison work, but no new primary skills were imported from them in this batch:
-
-- `obra/superpowers`
-- `muratcankoylan/agent-skills-for-context-engineering`
-- `PleasePrompto/notebooklm-skill`
-
-## Validation
-
-Commands run during the import:
-
-```bash
-npm run validate
-npm run index
-npm run catalog
-```
-
-Result:
-
-- Validation passed after normalization.
-- Generated index count after import: `1304` skills.

package/bundled-skills/docs/maintainers/skills-update-guide.md

@@ -1,92 +0,0 @@
-# Skills Update Guide
-
-This guide explains how to update the skills in the Agentic Awesome Skills web application.
-
-## Automatic Updates (Recommended)
-
-The `START_APP.bat` file automatically checks for and updates skills when you run it. It uses multiple methods:
-
-1. **Git method** (if Git is installed): Fast and efficient
-2. **PowerShell download** (fallback): Works without Git
-
-## Manual Update Options
-
-### Option 1: Using npm script (Recommended for manual updates)
-```bash
-npm run update:skills
-```
-
-This command:
-- Generates the latest skills index from the skills directory
-- Copies it to the web app's public directory
-- Requires Python and PyYAML to be installed
-
-### Option 2: Using START_APP.bat (Integrated solution)
-```bash
-START_APP.bat
-```
-
-The START_APP.bat file includes integrated update functionality that:
-- Automatically checks for updates on startup
-- Uses Git if available (fast method)
-- Falls back to HTTPS download if Git is not installed
-- Handles all dependencies automatically
-- Provides clear status messages
-- Works without any additional setup
-
-### Option 3: Manual steps
-```bash
-# 1. Generate skills index
-python tools/scripts/generate_index.py
-
-# 2. Copy canonical manifest to web app
-copy skills_index.json apps\web-app\public\skills.json
-```
-
-`tools/scripts/generate_index.py` writes the canonical root `skills_index.json` and mirrors the same array payload to `data/skills_index.json` for compatibility readers.
-
-## Prerequisites
-
-For manual updates, you need:
-
-- **Python 3.x**: Download from [python.org](https://python.org/)
-- **PyYAML**: Install with `pip install PyYAML`
-
-## Troubleshooting
-
-### "Python is not recognized"
-- Install Python from [python.org](https://python.org/)
-- Make sure to check "Add Python to PATH" during installation
-
-### "PyYAML not found"
-- Install with: `pip install PyYAML`
-- Or run the update script which will install it automatically
-
-### "Failed to copy skills"
-- Make sure the `apps\web-app\public\` directory exists
-- Check file permissions
-
-## What Gets Updated
-
-The update process refreshes:
-- Canonical skills index (`skills_index.json`)
-- Compatibility mirror (`data/skills_index.json`)
-- Web app skills data (`apps\web-app\public\skills.json`)
-- All 2,108+ skills from the skills directory
-
-## When to Update
-
-Update skills when:
-- New skills are added to the repository
-- You want the latest skill descriptions
-- Skills appear missing or outdated in the web app
-
-## Git Users
-
-If you have Git installed and want to update the entire repository:
-```bash
-git pull origin main
-npm run update:skills
-```
-
-This pulls the latest code and updates the skills data.

package/bundled-skills/docs/maintainers/smart-auto-categorization.md

@@ -1,218 +0,0 @@
-# Smart Auto-Categorization Guide
-
-## Overview
-
-The skill collection now uses intelligent auto-categorization to eliminate "uncategorized" and organize skills into meaningful categories based on their content.
-
-## Current Status
-
-✅ Current repository indexed through the generated catalog
-- Most skills are in meaningful categories
-- A smaller tail still needs manual review or better keyword coverage
-- `skills_index.json` is the source of truth for current category labels and counts
-- Category filters should be derived from the generated index at build time
-
-## Category Distribution
-
-Do not copy fixed counts into user-facing docs. To inspect the current distribution, generate it from the index:
-
-```bash
-node - <<'NODE'
-const fs = require('fs');
-const skills = JSON.parse(fs.readFileSync('skills_index.json', 'utf8'));
-const counts = new Map();
-for (const skill of skills) {
-  const category = skill.category || 'uncategorized';
-  counts.set(category, (counts.get(category) || 0) + 1);
-}
-console.log(`skills=${skills.length} categories=${counts.size}`);
-for (const [category, count] of [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 12)) {
-  console.log(`${category}: ${count}`);
-}
-NODE
-```
-
-## How It Works
-
-### 1. **Keyword-Based Analysis**
-The system analyzes skill names and descriptions for keywords:
-- **Backend**: nodejs, express, fastapi, django, server, api, database
-- **Web Dev**: react, vue, angular, frontend, css, html, tailwind
-- **AI/ML**: ai, machine learning, tensorflow, nlp, gpt
-- **DevOps**: docker, kubernetes, ci/cd, deploy
-- And more...
-
-### 2. **Priority System**
-Frontmatter category > Detected Keywords > Fallback (uncategorized)
-
-If a skill already has a category in frontmatter, that's preserved.
-
-### 3. **Scope-Based Matching**
-- Exact phrase matches weighted 2x higher than partial matches
-- Uses word boundaries to avoid false positives
-
-## Using the Auto-Categorization
-
-### Run on Uncategorized Skills
-```bash
-python tools/scripts/auto_categorize_skills.py
-```
-
-### Preview Changes First (Dry Run)
-```bash
-python tools/scripts/auto_categorize_skills.py --dry-run
-```
-
-### Output
-```
-======================================================================
-AUTO-CATEGORIZATION REPORT
-======================================================================
-
-Summary:
-   ✅ Categorized: 776
-   ⏭️  Already categorized: 46
-   ❌ Failed to categorize: 124
-   📈 Total processed: full repository
-
-Sample changes:
-   • 3d-web-experience
-     uncategorized → web-development
-   • ab-test-setup
-     uncategorized → testing
-   • agent-framework-azure-ai-py
-     uncategorized → backend
-```
-
-## Web App Improvements
-
-### Category Filter
-**Before:**
-- Unordered list including "uncategorized"
-- No indication of category size
-
-**After:**
-- Categories sorted by skill count (most first, "uncategorized" last)
-- Shows counts from the generated index instead of hard-coded documentation numbers
-- Much easier to browse
-
-### Example Dropdowns
-
-**Sorted Order:**
-1. All Categories
-2. Highest-count generated category
-3. Next generated category
-4. ... more generated categories ...
-5. Uncategorized, if present, at the end
-
-## For Skill Creators
-
-### When Adding a New Skill
-
-Include category in frontmatter:
-```yaml
----
-name: my-skill
-description: "..."
-category: web-development
-date_added: "2026-03-06"
----
-```
-
-### If You're Not Sure
-
-The system will automatically categorize on next index regeneration:
-```bash
-python tools/scripts/generate_index.py
-```
-
-## Keyword Reference
-
-Available auto-categorization keywords by category:
-
-**Backend**: nodejs, node.js, express, fastapi, django, flask, spring, java, python, golang, rust, server, api, rest, graphql, database, sql, mongodb
-
-**Web Development**: react, vue, angular, html, css, javascript, typescript, frontend, tailwind, bootstrap, webpack, vite, pwa, responsive, seo
-
-**Database**: database, sql, postgres, mysql, mongodb, firestore, redis, orm, schema
-
-**AI/ML**: ai, machine learning, ml, tensorflow, pytorch, nlp, llm, gpt, transformer, embedding, training
-
-**DevOps**: docker, kubernetes, ci/cd, git, jenkins, terraform, ansible, deploy, container, monitoring
-
-**Cloud**: aws, azure, gcp, serverless, lambda, storage, cdn
-
-**Security**: encryption, cryptography, jwt, oauth, authentication, authorization, vulnerability
-
-**Testing**: test, jest, mocha, pytest, cypress, selenium, unit test, e2e
-
-**Mobile**: mobile, react native, flutter, ios, android, swift, kotlin
-
-**Automation**: automation, workflow, scripting, robot, trigger, integration
-
-**Game Development**: game, unity, unreal, godot, threejs, 2d, 3d, physics
-
-**Data Science**: data, analytics, pandas, numpy, statistics, visualization
-
-## Customization
-
-### Add Custom Keywords
-
-Edit [`tools/scripts/auto_categorize_skills.py`](../../tools/scripts/auto_categorize_skills.py):
-
-```python
-CATEGORY_KEYWORDS = {
-    'your-category': [
-        'keyword1', 'keyword2', 'exact phrase', 'another-keyword'
-    ],
-    # ... other categories
-}
-```
-
-Then re-run:
-```bash
-python tools/scripts/auto_categorize_skills.py
-python tools/scripts/generate_index.py
-```
-
-## Troubleshooting
-
-### "Failed to categorize" Skills
-
-Some skills may be too generic or unique. You can:
-
-1. **Manually set category** in the skill's frontmatter:
-```yaml
-category: your-chosen-category
-```
-
-2. **Add keywords** to CATEGORY_KEYWORDS config
-
-3. **Move to folder** if it fits a broader category:
-```
-skills/backend/my-new-skill/SKILL.md
-```
-
-### Regenerating Index
-
-After making changes to SKILL.md files:
-```bash
-python tools/scripts/generate_index.py
-```
-
-This will:
-- Parse frontmatter categories
-- Fallback to folder structure
-- Generate new skills_index.json
-- Copy to apps/web-app/public/skills.json
-
-## Next Steps
-
-1. **Test in web app**: Try the improved category filter
-2. **Add missing keywords**: If certain skills are still uncategorized
-3. **Organize remaining uncategorized skills**: Either auto-assign or manually review
-4. **Monitor growth**: Use reports to track new vs categorized skills
-
----
-
-**Result**: Much cleaner category filter with smart, meaningful organization! 🎉

package/bundled-skills/docs/plugin-submissions/aas-agent-mcp-builder/README.md

@@ -1,19 +0,0 @@
-# AAS Agent & MCP Builder submission dossier
-
-This directory is the version-controlled source for the first proposed public AAS listing in the universal ChatGPT and Codex Plugins Directory.
-
-The submission is intentionally **skills-only**. The existing AAS Core MCP remains local, offline, read-only, and separately distributed; it is not presented as a public production endpoint.
-
-## Included evidence
-
-- [`submission.json`](submission.json) contains the listing copy, public URLs, starter prompts, release notes, package paths, and the remaining publisher-owned decisions.
-- [`evaluation-cases.json`](evaluation-cases.json) contains six positive and four negative reviewer-reproducible cases.
-- [`evaluation-results.json`](evaluation-results.json) records a complete 10/10 Codex CLI pass from ephemeral, read-only conversations against the installed 15.10.0 plugin, including the client warnings that must remain visible during final review.
-- The final upload source is [`plugins/agentic-bundle-aas-agent-mcp-builder/`](../../../plugins/agentic-bundle-aas-agent-mcp-builder/), generated from canonical skills and validated with the repository's bundle and plugin gates.
-- The production logo source is [`apps/web-app/public/web-app-manifest-512x512.png`](../../../apps/web-app/public/web-app-manifest-512x512.png).
-
-## Publication boundary
-
-Repository automation can prepare and validate the complete draft, but it cannot truthfully select a verified publisher identity, accept OpenAI policy attestations, or choose legal availability on behalf of the account holder. Those fields must be confirmed in the OpenAI Platform before **Submit for Review**.
-
-Submission starts OpenAI review; it does not immediately publish the plugin. After approval, the verified publisher must perform the separate publish action in the portal.