Implement Agent Skills

Purpose

This skill helps implement new Agent Skills by first identifying the target AI coding tool environment to ensure the created skill is compatible with the user's workflow.

1. Identify AI Coding Tool

Check the project for indicators of AI coding tools:

• •Cursor: Presence of .cursor/ directory, .cursorrules, or .cursorignore.
• •Claude Code: Presence of .claude/ directory or claude.json.
• •Gemini CLI: Presence of gemini.json or specific environment variables.

Logic

1. •Scan the workspace root for these indicators.
2. •Analyze the findings:
   • •If one tool is detected -> Proceed with that tool as the target.
   • •If multiple tools are detected -> Ask the user which tool to target.
   • •If no tools are detected -> Ask the user to specify the tool.

2. Interaction Strategy

If you need to ask the user, use the AskQuestion tool if available, or ask conversationally.

Example Question: "I detected multiple AI coding tools (Cursor and Claude Code). Which one should I target for this Agent Skill?"

• • Cursor
• • Claude Code
• • Gemini CLI

3. Implementation Context

Once the tool is identified, tailor the Agent Skill implementation accordingly:

• •

  Cursor:

  • •Target: .cursor/skills/ (project) or ~/.cursor/skills/ (global).
  • •Format: Standard SKILL.md with YAML frontmatter.
• •

  Claude Code:

  • •Target: .claude/skills/ (project) or ~/.claude/skills/ (global).
  • •Format: Follow Claude Code skill conventions.
• •

  Gemini CLI:

  • •Follow Gemini CLI specific skill structure.

4. Standards & Templates

When implementing a new skill, always follow the established best practices and select the most appropriate template as a starting point.

Specification Compliance

Ensure the skill follows the official Agent Skills specification:

• •Naming: Directory and SKILL.md name must be kebab-case and match.
• •Frontmatter: Include all required fields (name, description). Use optional fields (license, compatibility, metadata, allowed-tools) if applicable.
• •Structure: Use scripts/, references/, and assets/ subdirectories to offload details for progressive disclosure.

Validation

Before completing the task:

1. •Check Syntax: Verify YAML frontmatter is valid.
2. •Validate: If the skills-ref tool is available, run skills-ref validate ./<skill-directory>.
3. •Manual Review: Ensure the description is keyword-rich for discovery.

Best Practices

See references/best-practices.md for detailed naming, description, and progressive disclosure standards.

Available Templates

Select the template that best matches the skill's purpose: