SKILL.md

name	template-skill
description	Replace with a clear description of what this skill does and when Claude should use it. Be specific about the use cases, tools, or workflows this skill addresses.

Skill Name

Brief introduction explaining what this skill helps users accomplish.

When to Use This Skill

Use this skill when:

• Specific use case 1
• Specific use case 2
• Specific use case 3

Core Principles

1. First Key Concept

Explanation of the first important concept or pattern.

Example:

# Show concrete example
key: value

2. Second Key Concept

Explanation of the second important concept.

-- SQL example if relevant
SELECT * FROM table_name

3. Additional Concepts

Continue with other important concepts, patterns, or best practices.

Common Patterns

Pattern 1: Descriptive Name

# Show a complete, realistic example
example:
  key: value
  nested:
    - item1
    - item2

Explanation: Describe what this pattern does and when to use it.

Pattern 2: Another Pattern

Provide another common use case with example code.

Best Practices

1. Practice 1 - Clear guideline
2. Practice 2 - Another guideline
3. Practice 3 - And so on

Common Issues and Solutions

Issue: Problem Description

Symptoms:

• What the user sees
• Error messages

Solutions:

1. First solution approach
2. Alternative approach
3. Workaround if needed

Example:

# Show the fix
corrected:
  example: here

Advanced Topics

Advanced Feature 1

For users who need more sophisticated functionality.

Advanced Feature 2

Additional advanced patterns or techniques.

Workflow Example

Step-by-step example of a complete workflow:

1. Step 1: Do this first
2. Step 2: Then do this
3. Step 3: Finally complete with this

# Complete working example
complete:
  workflow:
    step1: value
    step2: value

Related Skills

• Link to related skill if applicable
• Another related skill

Resources

• Official documentation links
• Internal TD resources
• Related tools or services

---

Template Usage Notes

When creating a new skill from this template:

1. Update the frontmatter:

   • Change name to your skill's unique identifier (lowercase-with-hyphens)
   • Write a clear description that explains when Claude should use this skill

2. Replace the content:

   • Update the main heading
   • Fill in "When to Use This Skill" with specific scenarios
   • Add core principles and concepts specific to your domain
   • Provide realistic, working examples
   • Include common patterns from your area of expertise

3. Focus on TD-specific patterns:

   • Include TD conventions and best practices
   • Reference internal tools and workflows
   • Use realistic TD table names and data patterns
   • Include timezone considerations (JST/UTC)

4. Make it actionable:

   • Provide complete, copy-paste-ready examples
   • Include error handling patterns
   • Show debugging approaches
   • Add troubleshooting sections

5. Keep it maintainable:

   • Add version comments if tracking changes
   • Include last updated date
   • Link to authoritative documentation
   • Note any TD-specific limitations or requirements

6. Test your skill:

   • Verify all examples work
   • Test with Claude Code
   • Get feedback from potential users
   • Update based on real-world usage