diff --git a/.agent/rules/rules.md b/.agent/rules/rules.md deleted file mode 100644 index 04dfc11f..00000000 --- a/.agent/rules/rules.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -trigger: always_on -glob: -description: ---- - -1. alla fine del processo di modifica ricordati di fare il push della repo su github. -2. ricordati sempre di aggiornare ongi singola parte della repo, dall'inizio alla fine diff --git a/MAINTENANCE.md b/MAINTENANCE.md deleted file mode 100644 index 3972898c..00000000 --- a/MAINTENANCE.md +++ /dev/null @@ -1,57 +0,0 @@ -# Repository Maintenance Protocol - -To ensure consistency and quality, the following steps MUST be performed for **every single change** involving skills or documentation. - -## 1. Skill Creation & Modification - -- [ ] **Check Duplicates**: Before adding a skill, check `skills_index.json` or `ls skills/` to ensure it doesn't exist. -- [ ] **Folder Structure**: Each skill must have its own folder in `skills/`. -- [ ] **SKILL.md**: Every skill directory MUST contain a `SKILL.md` file with valid frontmatter: - - ```markdown - --- - name: Skill Name - description: Brief description. - --- - ``` - -## 2. Validation & Indexing (CRITICAL) - -Running the scripts is **MANDATORY** after any change to `skills/`. - -- [ ] **Validate Skills**: Run the validation script to check for formatting errors. - - ```bash - python3 scripts/validate_skills.py - ``` - -- [ ] **Generate Index**: Update `skills_index.json`. This is the source of truth for the agent. - - ```bash - python3 scripts/generate_index.py - ``` - -## 3. Documentation Updates - -The `README.md` does not auto-update. You must manually sync it with the index. - -- [ ] **About / Introduction**: Update the total count in the opening paragraph and blockquote. - - `> **The Ultimate Collection of [X]+ Agentic Skills...` - - `...library of **[X] high-performance skills**...` -- [ ] **Features & Categories Table**: If the new skill fits a category, update the table in `# Features & Categories`. -- [ ] **Full Skill Registry Table**: Add the new skill to the main table. - - Format: `| **[Name]** | [Description] | [Path] |` - - Verify alphabetical order. -- [ ] **Credits & Sources**: If the skill was imported from a community repo, add a credit link in `# Credits & Sources`. - - Example: `- **[repo-name](url)**: Source for [skill-name].` - -## 4. Git Operations - -- [ ] **Check Status**: `git status` to see what changed. -- [ ] **Add All Files**: Ensure new skill folders are added (`git add skills/`). -- [ ] **Commit**: Use a descriptive Conventional Commit message (e.g., `feat: add new security skills`, `docs: update readme count`). -- [ ] **Push**: `git push` to origin. **NEVER FORGET THIS.** - -## 5. Agent Artifacts (Internal) - -- [ ] **Walkthrough**: Update `walkthrough.md` in the brain/artifact directory to reflect the session's achievements. diff --git a/walkthrough.md b/walkthrough.md deleted file mode 100644 index b79c02b8..00000000 --- a/walkthrough.md +++ /dev/null @@ -1,56 +0,0 @@ -# OpenAI Skills Extraction Walkthrough - -I have successfully extracted and adapted valuable patterns from the `openai/skills` repository into our local collection. - -## Changes Made - -### New Skills - -Adapted from OpenAI's curated and experimental catalogs: - -- **[address-github-comments](file:///Users/nicco/Antigravity%20Projects/antigravity-awesome-skills/skills/address-github-comments/SKILL.md)**: A systematic guide for addressing PR and issue feedback using the `gh` CLI. -- **[concise-planning](file:///Users/nicco/Antigravity%20Projects/antigravity-awesome-skills/skills/concise-planning/SKILL.md)**: A template-driven skill for generating atomic, actionable checklists for development tasks. - -### Skill Improvements - -Improved our existing skill authoring standards using OpenAI's `skill-creator` principles: - -- **[writing-skills](file:///Users/nicco/Antigravity%20Projects/antigravity-awesome-skills/skills/writing-skills/SKILL.md)**: Integrated "Degrees of Freedom" and "Progressive Disclosure" principles to optimize context usage and instruction specificity. - -### Global Integration - -- Updated [skills_index.json](file:///Users/nicco/Antigravity%20Projects/antigravity-awesome-skills/skills_index.json) to register the new skills. -- Updated [README.md](file:///Users/nicco/Antigravity%20Projects/antigravity-awesome-skills/README.md) to include them in the registry and add `openai/skills` to the **Credits & Sources** section. - -## Verification Results - -### Automated Validation - -I ran the `validate_skills.py` script, and all skills passed. - -```bash -🔍 Validating skills in: /Users/nicco/Antigravity Projects/antigravity-awesome-skills/skills -✅ Found and checked 71 skills. -✨ All skills passed basic validation! -``` - -### Manual Audit - -- Verified frontmatter formatting for both new skills. -- Confirmed that the "Progressive Disclosure" and "Degrees of Freedom" sections were correctly merged into `writing-skills`. -- Verified that the README table links and descriptions match the new skills. - -### GitHub Deployment - -- Pushed the changes to the `main` branch of [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills). - ```bash - faf478f..113bc99 main -> main - ``` - ---- - -Summary of final updates: - -- Added `openai/skills` to Credits. -- Updated total skill count to **71** across the entire README. -- Populated the **Full Skill Registry** table with all 71 skills.