chore: remove MAINTENANCE.md, walkthrough.md and .agent/rules
This commit is contained in:
sck_0
@@ -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
|
||||
@@ -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-name>`.
|
||||
- [ ] **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.
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user