From 3d936eee252e7ee5d897ee93f41c5f7ce0d087f5 Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sun, 30 Nov 2025 09:03:03 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 12 +++ README.md | 3 + plugin.lock.json | 44 +++++++++ skills/template-skill/SKILL.md | 163 +++++++++++++++++++++++++++++++++ 4 files changed, 222 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 plugin.lock.json create mode 100644 skills/template-skill/SKILL.md diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..4cedd88 --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,12 @@ +{ + "name": "template-skill", + "description": "Template for creating new TD-specific Claude Code skills with best practices and standard structure", + "version": "0.0.0-2025.11.28", + "author": { + "name": "Treasure Data", + "email": "support@treasuredata.com" + }, + "skills": [ + "./skills/template-skill" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..29907db --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# template-skill + +Template for creating new TD-specific Claude Code skills with best practices and standard structure diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..b7adc8a --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,44 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:treasure-data/td-skills:template-skill", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "5ad5b1587829bd318841dc6fe853d85b4fbf0ba8", + "treeHash": "4ab6a225fe80384da1100e7780be2ad97e4df8c11beda78018d19fa7e05ee0d9", + "generatedAt": "2025-11-28T10:28:46.800944Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "template-skill", + "description": "Template for creating new TD-specific Claude Code skills with best practices and standard structure" + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "8aee69c4ec5e74e9265a1c66a723c61e75eeb538d711f2be6e29710e0faab04b" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "f7212238c8fa644e979a08d0eaa93b5d2203e9f4ef5663b679425716e58dafc3" + }, + { + "path": "skills/template-skill/SKILL.md", + "sha256": "ae8fd475b620cf00d91d9b498f7a73a5da420ff6e9129abab8e143bb66bd3fc2" + } + ], + "dirSha256": "4ab6a225fe80384da1100e7780be2ad97e4df8c11beda78018d19fa7e05ee0d9" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file diff --git a/skills/template-skill/SKILL.md b/skills/template-skill/SKILL.md new file mode 100644 index 0000000..7d437f8 --- /dev/null +++ b/skills/template-skill/SKILL.md @@ -0,0 +1,163 @@ +--- +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:** +```yaml +# Show concrete example +key: value +``` + +### 2. Second Key Concept + +Explanation of the second important concept. + +```sql +-- 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 + +```yaml +# 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:** +```yaml +# 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 + +```yaml +# 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