add-skill

Guide adding global and project-local skills with dotfiles and symlinks.

Updated Jan 22, 2024
One-click install
npx skills add https://github.com/nathankoerschner/dotfiles --skill add-skill-nathankoerschner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-skill
Source: https://github.com/nathankoerschner/dotfiles/tree/main/agent-skills/_shared-skills/add-skill
Command: npx skills add https://github.com/nathankoerschner/dotfiles --skill add-skill-nathankoerschner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of adding new capabilities to your AI assistant, ensuring they are correctly integrated whether for global use or project-specific needs.

Core Features & Use Cases

  • Scope Determination: Clearly distinguishes between global (dotfiles-managed) and repo-local skills.
  • Workflow Guidance: Provides step-by-step instructions for creating and integrating new skills.
  • Verification: Includes commands to confirm that new skills are correctly recognized by the AI system.
  • Use Case: You want to add a new skill to help manage your calendar. This skill will guide you through creating the necessary files and configurations so your AI can access and manage your schedule.

Quick Start

Help me add a new global skill called 'calendar-manager' to help me manage my schedule.

Frequently Asked Questions about add-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add new skills to my AI assistant?

Adding new skills involves creating skill directories, defining frontmatter, and setting up symlinks for your specific AI platform. This process ensures the assistant correctly recognizes and integrates the new capabilities for either global or project-specific use.

What is the difference between global skills and project-local skills?

Global skills are managed through dotfiles and apply universally across your environment, while project-local skills are specific to a single repository. The integration process differs based on which scope you choose for your AI assistant.

How do I set up symlinks for AI platforms like Claude and Codex?

Setting up symlinks for AI platforms like Claude and Codex involves creating specific directory links during the integration process. This connects your skill files and frontmatter to the platform's recognized paths so they can be accessed.

How can I verify that a new skill is correctly recognized by my AI system?

You can verify that a new skill is correctly recognized by your AI system by running stowing and path checks. These commands confirm that the newly created directories and symlinks are properly configured and accessible.

Can I create repo-specific skills that are not managed by dotfiles?

Yes, you can create repo-specific skills that are not managed by dotfiles. The workflow outlines how to set up project-local capabilities that remain entirely independent of your global AI assistant configuration.

Do I need to define frontmatter when creating a new skill directory?

Yes, defining frontmatter is a required step when creating a new skill directory. It provides the necessary metadata for the AI assistant to properly read, process, and integrate the skill into its system.