polymath-void/ai-agents-skills-workspace/ai-agent-skill-crafting

Claude Code and agent skill by polymath-void/ai-agents-skills-workspace

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Core AI agent meta-skill for adapting, sourcing, creating, structuring, and refining modular knowledge skills for Antigravity AGY, Gemini CLI, Hermes, and custom AI agents.

Install

npx vskill@latest install polymath-void/ai-agents-skills-workspace/ai-agent-skill-crafting

SKILL.md

The same SKILL.md was published earlier as polymath-void/ai-agents-skills-workspace/ai-agent-skill-crafting.

🧠 Core AI Agent Skill Crafting & Refining Meta-Skill (ai-agent-skill-crafting)

This meta-skill defines standard operating procedures and core principles for AI agents to adapt, source, author, structure, and continuously refine specialized skill packages across workspaces.


🎯 1. The Skill Life-Cycle Pipeline

mermaid
graph TD
Source[1. Source Knowledge - Audit Repos & Codebases] --> Structure[2. Structure Spec - YAML Frontmatter & Markdown]
Structure --> Author[3. Author Content - Commands, Diffs, DSOs & Rules]
Author --> Verify[4. Verify & Adapt - Test Executables & Sub-Skills]
Verify --> Distribute[5. Distribute & Sync - Local System & GitHub Workspace]

πŸ” 2. Sourcing Knowledge from the Core

Before writing a skill, agents must gather empirical evidence directly from authoritative source files:

  1. Codebase Inspection: Read exact method signatures, prototypes (e.g., piuu_core.h, LibC.kt), and build configurations (CMakeLists.txt, build.gradle).
  2. CLI & Help Flag Execution: Test binary flags non-destructively (agy-backup --help, gh run view --help).
  3. Environment Audit: Inspect path variables ($PREFIX/bin), shebangs, Python interpreters, and git remote URLs.

πŸ“ 3. Standardized Skill Specification & Metadata Structure

Every skill MUST be saved inside its own dedicated directory (user-skills/<skill-name>/SKILL.md) with clean YAML frontmatter:

markdown
---
name: skill-identifier-name
description: Concise 1-2 sentence description explaining the purpose, scope, and target integration of this skill.
---
# 🎨 Skill Title (`skill-identifier-name`)
## πŸ“Œ 1. Scope & Overview
[High-level explanation of problem domain and solution]
## ⚑ 2. Executable Code & Commands

Copy-pasteable, robust shell commands

## πŸ—οΈ 3. Architecture & Design Principles
[Diagrams, structural guidelines, edge-case prevention]
## πŸ§ͺ 4. Verification & Testing Strategy
[Verification steps, assertion checks]

πŸ”„ 4. Adapting & Internalizing Skills

When an AI agent reads a SKILL.md specification:

  1. Extract Core Directives: Identify mandatory rules (e.g. "Always perform whole-environment backup" or "Do not auto-push without confirmation").
  2. Execute Sub-Skills: If the skill defines sub-skill verification routines or calculation foot-printing, execute the sub-skill pipeline completely.
  3. State Persistence: Update system memory files (MEMORY.md, AGENTS.md) to retain knowledge across session resets.

🧹 5. Distribution & Refinement Workflow

To publish or update a skill across system environments:

bash
# 1. Write skill specification in workspace repository
# File: $HOME/Workspace/ai-agents-skills-workspace/user-skills/<skill-name>/SKILL.md
# 2. Run the organization script to automatically sort skills into user-skills or system-skills
cd $HOME/Workspace/ai-agents-skills-workspace
python3 organize_skills.py
# 3. Sync to local active agent CLI skill directories
mkdir -p ~/.gemini/antigravity-cli/skills/<skill-name> ~/.gemini/antigravity-cli/builtin/skills/<skill-name>
cp -r $HOME/Workspace/ai-agents-skills-workspace/user-skills/<skill-name>/* ~/.gemini/antigravity-cli/skills/<skill-name>/
cp -r $HOME/Workspace/ai-agents-skills-workspace/user-skills/<skill-name>/* ~/.gemini/antigravity-cli/builtin/skills/<skill-name>/
# 4. Commit and push to remote skills repository
git add .
git commit -m "feat(skills): add/organize <skill-name> core skill"
git push origin main

πŸ”’ 6. Global Privacy & Data Isolation Rule

When creating or refining skills, agents MUST adhere to strict data privacy standards:

  1. Zero Personal Data Exposure: NEVER hardcode personal user tokens, private account credentials, machine-specific account switches (gh auth switch --user ...), or private SSH keys inside SKILL.md specifications.
  2. Portable Environment Referencing: Use dynamic environment variables ($HOME, ~, $PREFIX) instead of hardcoded environment paths.
  3. User-Centric Data Awareness: Direct the agent to interact with the user's data dynamically rather than embedding static personal identifiers.

πŸ› οΈ Required & Associated Agent Workspace Tools

When authoring, formatting, or discovering skills, activate these tools from `AI-Agents-Workspace-Tools-Library`:

  • `wc-json-prompt` (`docs`): Extracts and repairs unformatted JSON payloads embedded inside natural language prompts.
  • `wc-json-schema` (`docs`): Generates standard JSON schemas for structured skill inputs/outputs.
  • `wc-tool-registry` (`docs`): Queries and indexes tools across all workspace categories.
  • `wc-search` (`docs`): Performs noise-free symbol and keyword discovery across repositories.
  • Upcoming Tool Note: wc-skill-pack (Automated SKILL.md YAML frontmatter linter and skill bundler) is scheduled for implementation.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/polymath-void/ai-agents-skills-workspace/ai-agent-skill-crafting/badge)](https://verified-skill.com/skills/polymath-void/ai-agents-skills-workspace/ai-agent-skill-crafting)

Something wrong with this skill or its page? Tell us.