This directory contains GitHub Copilot skills for effective use of the SAP ABAP ADT MCP server tools.

• get-object-info - Retrieve ABAP object information and source code
• search-object - Search for ABAP objects by name or pattern
• where-used-search - Find where ABAP objects are used (dependency analysis)

• get-atc-results - Check code quality and cloud readiness with ATC
• get-released-api - Find cloud-ready API alternatives for legacy objects

• create-ai-object - Create new ABAP objects with AI-generated code
• change-ai-object - Update existing ABAP objects (restricted to $TMP)
• activate-object - Activate objects and perform syntax checking

• sap-help-search - Search official SAP Help Portal documentation
• sap-community-search - Search SAP Community for tutorials and real-world examples

• data-preview - Execute SELECT-only queries against tables and CDS views

These skills are automatically triggered when you ask questions that match their descriptions. You don't need to manually activate them - just ask naturally!

Search for objects:

Find all classes starting with ZCL_SALES

Automatically triggers: search-object skill

View source code:

Show me the code for class ZCL_CUSTOMER_MANAGER

Automatically triggers: get-object-info skill

Check code quality:

Run ATC checks on program ZMY_REPORT

Automatically triggers: get-atc-results skill

Create new objects:

Create an ABAP class ZP_ORDER_HANDLER that processes sales orders

Automatically triggers: create-ai-object skill

Find documentation:

Search SAP Help for RAP business object implementation

Automatically triggers: sap-help-search skill

Each skill follows this structure:

skill-name/
└── SKILL.md          # Skill definition with YAML frontmatter and markdown instructions

---
name: skill-name
description: What the skill does and when to use it (triggers automatic loading)
license: MIT
---

# Skill Title

Detailed instructions, parameters, examples, and best practices...

1. Search → Find relevant objects
2. Get Info → Study existing implementations
3. Create → Build new object
4. Activate → Check syntax
5. ATC Check → Validate quality

1. ATC Check → Find non-cloud-ready code
2. Get Released API → Find modern alternatives
3. SAP Help Search → Research new APIs
4. Change Object → Refactor code
5. ATC Re-check → Verify compliance

1. SAP Help Search → Official documentation
2. SAP Community Search → Real-world tutorials
3. Search Object → Find system examples
4. Get Object Info → Study implementation
5. Create Object → Practice building

• get-object-info
• search-object
• where-used-search
• get-atc-results
• get-released-api
• sap-help-search
• sap-community-search
• data-preview

• create-ai-object (creates in $TMP only)
• change-ai-object (modifies $TMP objects only)
• activate-object (Z* objects only)

All skills include built-in safety measures:

• create-ai-object: Creates only in $TMP package
• change-ai-object: Modifies only $TMP objects
• activate-object: Works only with Z*/Y* objects
• data-preview: SELECT-only queries, blocks DML/DDL

• SKILLS-README.md - Complete guide to GitHub Copilot skills
• README.md - MCP server documentation
• copilot-instructions.md - Repository-specific instructions

1. Be specific in your questions - Skills trigger based on description matching
2. Use natural language - No need for exact command syntax
3. Combine skills - Many workflows use multiple skills in sequence
4. Check the output - Skills provide detailed feedback and next-step recommendations
5. Iterate - Use skills repeatedly to refine results

When adding new MCP tools to the server:

1. Add tool definition in src/index.ts
2. Create handler in src/handlers/
3. Create corresponding skill in this directory
4. Update this README with the new skill
5. Test that Copilot triggers the skill appropriately

Use this template when creating new skills:

---
name: your-skill-name
description: Clear description with keywords that match how users will ask. Include use cases, actions, and terminology.
license: MIT
---

# Your Skill Title

Brief overview of what this skill does.

## When to Use This Skill

- Bullet points of specific use cases
- When to apply this skill
- What problems it solves

## Parameters

Document required and optional parameters...

## Usage Examples

Provide real-world example questions...

## Output Expectations

What users should expect...

## Integration with Other Skills

How this skill fits into larger workflows...

## Best Practices

Tips for effective use...

Good skills have:

• ✅ Clear, keyword-rich descriptions for auto-triggering
• ✅ Comprehensive usage examples
• ✅ Integration guidance with other skills
• ✅ Security and safety considerations
• ✅ Common error handling patterns
• ✅ Best practices and tips

Ready to use these skills? Just start asking questions in GitHub Copilot - the skills will automatically activate when relevant!