skills.rest
scylladb
scylladbOFFICIAL
Explore all skills by this author →
Website𝕏@ScyllaDBGitHub

designing-skills

Guide AI agent skill design for the SCT repository with modular directories.

73|112|Updated Dec 29, 2015
Search Tags:#documentation#prompt engineering#AI agent#skill design#developer guidance#SCT repository
One-click install
npx skills add https://github.com/scylladb/scylla-cluster-tests --skill designing-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: designing-skills
Source: https://github.com/scylladb/scylla-cluster-tests/tree/main/skills/designing-skills
Command: npx skills add https://github.com/scylladb/scylla-cluster-tests --skill designing-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and workflows (resource) components.

What problem does it solve?

This Skill provides a structured framework and best practices for designing, building, and maintaining AI agent skills within the SCT repository, ensuring consistency and effectiveness across platforms.

Core Features & Use Cases

  • Skill Design Guidance: Learn principles for capturing intent, structuring content, and writing effective descriptions.
  • Platform Compatibility: Understand how to make skills discoverable by both GitHub Copilot and Claude Code.
  • Workflow & Reference Management: Guidance on splitting complex tasks into modular references/ and workflows/ directories.
  • Use Case: When you need to create a new AI agent skill for SCT, this guide will walk you through the entire process from initial concept to final registration and testing.

Quick Start

Use the designing-skills skill to learn how to create a new skill directory for the SCT repository.

Frequently Asked Questions about designing-skills

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

FAQPage Schema
How do I design AI agent skills for compatibility with both GitHub Copilot and Claude Code?▼

You can structure complex AI agent skills by splitting guidance into modular `references/` and `workflows/` directories, ensuring the SKILL.md file maintains progressive disclosure to prevent overwhelming the agent.

What is progressive disclosure in AI prompt engineering for agent skills?▼

Progressive disclosure in prompt engineering structures AI agent skills by separating core instructions in SKILL.md files from detailed workflows and references in modular directories, preventing context overload.

How do I create a new skill directory in an SCT repository?▼

To create a new skill directory in an SCT repository, capture intent, write effective descriptions, structure content modularly, and register the SKILL.md file for AI agent discoverability.

Can I refactor existing developer guidance into modular AI agent workflows?▼

Yes, you can refactor existing developer guidance into modular AI agent workflows by restructuring content into separate `references/` and `workflows/` directories and updating the SKILL.md file.

What are the best practices for writing effective AI agent skill descriptions?▼

Best practices for writing AI agent skill descriptions include capturing user intent clearly, structuring content for modularity, and ensuring text accurately represents the skill's processing logic.

Related Skills

Explore More Software Engineering Skills→
mrdonleemrdonlee

template-skill

Provide a basic template structure for creating new AI skills.

Community
Basic
drndrn
23

cross-agent

Migrate AI agent skills to the Agent Skills open standard for multi-platform compatibility.

Community
Advanced
AgentientAgentient
2

prompt-engineering

Create XML-structured system prompts with role, instructions, tools, and output sections.

Official
Advanced
devCharuzudevCharuzu

senior-prompt-engineer

Design prompts and evaluation frameworks for LLM workflows.

Community
Advanced