SkillKit Documentation
repository·main·Indexed 23 days ago
https://github.com/rohitg00/skillkitA package manager for AI agent skills that allows developers to install, translate, and manage skills across 46 different AI agents, such as Claude Code, Cursor, and Copilot. SkillKit provides a CLI for project-aware skill recommendations, security scanning for prompt and command injection, session memory management, and the ability to sync project context across multiple agents.
What's inside SkillKit
- The SkillKit Community Skills Registry is a curated collection of community-contributed skills designed for AI coding agents. These skills provide specialized knowledge and workflows across various domains such as Code Quality, Frontend, DevOps, Security, and AI/ML. You can use these skills to augment your agent's capabilities in specific technical areas.
Overview of SkillKit TUI Screens
mainThe TUI provides several specialized screens for managing your agent skills and workflows:
- Home: Dashboard with stats, detected agents, and features.
- Browse: Search and explore skill repositories.
- Marketplace: Curated skill marketplace with popularity metrics.
- Recommend: AI-powered suggestions based on your project.
- Installed: Manage installed skills (enable/disable/remove).
- Sync: Sync skills across multiple agents.
- Translate: Convert skills between agent formats.
- Workflow: Manage and execute automation workflows.
- Execute: Run skills with checkpoints.
- Plan: Structured plan creation and execution.
- Team: Share skills and bundles with team members.
- Context: View detected stack and project context.
- Memory: Session memory and learnings.
- Plugins: Plugin management.
- Methodology: Development methodology frameworks.
- Settings: Configure SkillKit preferences.
Understand Mesh Security Levels
mainThe mesh network supports different security profiles depending on your environment:
Level Discovery Transport Auth Use Case developmentopen none none Local dev signedsigned optional optional Trusted LAN secure(default)signed required required Production stricttrusted-only required mTLS High security Understand Design Levels
mainDesign can be applied at different granularities depending on the scope of the task:
- High-Level Design (Architecture): Focuses on system components, interactions, data flow, technology choices, and deployment architecture.
- Mid-Level Design (Module/Component): Focuses on class/module structure, interfaces, contracts, state management, and error handling strategies.
- Low-Level Design (Implementation): Focuses on algorithm details, specific data structures, method signatures, and edge case handling.
How SkillKit translation works
mainSkillKit uses a central
SKILL.md(Universal Format) as the intermediary. The translation flow follows this path:- Universal Format (SKILL.md)
- Adapter Interface
- Agent-Specific Formats
To implement a new adapter, the interface requires two methods:
getConfigPath(): Returns the skill directory.generateConfig(): Converts the content into the target format.
How Trust Badges are determined
mainSkills display trust badges based on their source and a quality analysis performed by the
TrustScorer.Badge Types
- [Official]: Published by a known official source (e.g., Anthropic, Vercel, iii-hq).
- [Trusted]: TrustScorer rates the skill 8-10.
- [Review]: TrustScorer rates the skill 5-7.
- [Caution]: TrustScorer rates the skill 0-4.
TrustScorer Dimensions
The score is a weighted composite of four dimensions:
- Clarity (30%): Purpose and instruction definition.
- Boundaries (25%): Adherence to declared scope.
- Specificity (25%): Actionability of instructions.
- Safety (20%): Absence of dangerous patterns (injection, exfiltration, secrets).
Use Task Decomposition to break down complex work
mainThe
task-decompositionskill is used when a project, feature, or research task feels too large to manage. The core principle is to break work down into small, atomic units that are independently completable, verifiable, and should ideally take no more than a few hours to finish.This skill is triggered by phrases such as:
- "break down"
- "decompose"
- "split into tasks"
- "too big"
- "where to start"
- "complex task"
How the Chrome Extension works
mainThe extension follows a specific pipeline to convert web content into agent-ready skills:
- Data Collection: The Popup reads the current tab's URL and title using the
activeTabpermission. No content script injection is required. - Processing: The Background service worker sends the URL to the SkillKit API (
skillkit.sh/api/save-skilloragenstskills.com/api/save-skill).- The server fetches the page and converts HTML to markdown using Turndown.
- GitHub URLs are automatically converted to raw content.
- Tags are generated using a weighted 5-source analysis (URL segments, headings, code blocks, keywords, and language).
- Delivery: The service worker receives the
SKILL.mdand uses thechrome.downloadsAPI to save the file to your disk.
Note on Privacy: The extension only sends the page URL to the server. It does not send page content, browsing history, or personal data. Selection-based saves are performed entirely locally in the browser.
- Data Collection: The Popup reads the current tab's URL and title using the
How the Memory System works
mainSkillKit's memory system follows an Observation → Learning Pipeline to convert AI session patterns into reusable skills:
- Observations: Tracks patterns during sessions (e.g., tool use, errors, solutions).
- Compression: Distills these observations into reusable learnings.
- Injection: Loads relevant learnings into new sessions to provide context.
- Export: Converts learnings into shareable skills.
Progressive Disclosure (Token Optimization)
To minimize token usage, the system uses a 3-layer retrieval model. It starts with the lightest layer and fetches deeper layers only as needed based on relevance and your token budget:
Layer Content ~Tokens Index Titles, tags, timestamps 50-100 Timeline Context, excerpts, activity ~200 Details Full content, metadata 500-1000 Memory Categories and Tiers in @skillkit/mcp-memory
mainMemories in
@skillkit/mcp-memoryare organized by categories and tiers to facilitate efficient retrieval and lifecycle management.Categories
fact: Factual informationdecision: Decisions madepreference: User preferencespattern: Observed patternsinsight: Derived insightsreasoning: Reasoning chains
Tiers
warm: Recent, frequently accessed memorieslong: Consolidated long-term memories
Lifecycle: Memories are automatically promoted from
warmtolongbased on access count, reinforcement score, and age.Understand TUI visual indicators and status icons
mainThe TUI uses specific visual cues to communicate skill quality and status.
Quality Grades
Skills are graded based on their score:
- A (90-100): Green
- B (80-89): Green
- C (70-79): Yellow
- D (60-69): Red
- F (Below 60): Red
Status and Agent Icons
●: Enabled○: Disabled⟁: Claude Code◫: Cursor◎: Codex✦: Gemini⬡: OpenCode
Relation types in the Skill Graph
mainWhen using
getRelatedSkills, you can filter by the following relation types:similar: Skills that share tags and functionality.complementary: Skills that work well together.dependency: Skills required by other skills.alternative: Different approaches to the same problem.