marketingjuliancongdanh79-pixel/skill-generator
skill-creator-ultra
VerifiedTạo AI Skill mới từ ý tưởng hoặc quy trình công việc. Kết hợp phỏng vấn thông minh, pattern detection, và quantitative evaluation để tạo skill chất lượng production. Dùng khi user nói "tạo skill", "biến quy trình thành skill", "make a new skill", "tự động hóa công việc này", hoặc mô tả quy trình lặp lại mà họ muốn AI tự làm. Cũng dùng khi user muốn cải thiện, test, hoặc optimize skill hiện có.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.4 KB |
| agents/analyzer.md | markdown | 10.1 KB |
| agents/comparator.md | markdown | 7.1 KB |
| agents/grader.md | markdown | 8.8 KB |
| assets/eval_review.html | other | 6.9 KB |
| examples/example_anthropic_frontend.md | markdown | 4.9 KB |
| examples/example_anthropic_pdf.md | markdown | 4.5 KB |
| examples/example_api_docs.md | markdown | 5.3 KB |
| examples/example_db_migration.md | markdown | 8.8 KB |
| examples/example_git_commit.md | markdown | 4.1 KB |
| scripts/ci_eval.py | script | 6.4 KB |
| scripts/package_skill.py | script | 4.9 KB |
| scripts/simulate_skill.py | script | 14.2 KB |
| scripts/skill_audit.py | script | 22.7 KB |
| scripts/skill_compare.py | script | 9.3 KB |
| scripts/skill_export.py | script | 9.6 KB |
| scripts/skill_scaffold.py | script | 11.7 KB |
| scripts/skill_stats.py | script | 11.6 KB |
| scripts/validate_skill.py | script | 15.0 KB |
scripts/simulate_skill.py
View on GitHub#!/usr/bin/env python3
"""
simulate_skill.py — Mô phỏng chạy thử Skill với input giả
Sử dụng:
python simulate_skill.py /path/to/SKILL.md
Script sẽ:
1. Parse SKILL.md
2. Trích xuất Instructions (các bước)
3. Trích xuất Examples (input/output mẫu)
4. Mô phỏng "dry run" — đi qua từng bước
5. Report: Bước nào rõ ràng, bước nào mơ hồ
"""
import sys
import os
import re
from pathlib import Path
class Colors:
PASS = '\033[92m'
FAIL = '\033[91m'
WARN = '\033[93m'
INFO = '\033[96m'
BOLD = '\033[1m'
DIM = '\033[2m'
RESET = '\033[0m'
@staticmethod
def enable_windows():
if os.name == 'nt':
try:
import ctypes
kernel32 = ctypes.windll.kernel32
kernel32.SetConsoleMode(kernel32.GetStdHandle(-11), 7)
except Exception:
pass
def parse_frontmatter(content):
"""Trích xuất YAML frontmatter."""
pattern = r'^---\s*\n(.*?)\n---\s*\n(.*)$'
match = re.match(pattern, content, re.DOTALL)
if not match:
return {}, content
yaml_content = match.group(1)
body = match.group(2)
frontmatter = {}
current_key = None
current_value = []
for line in yaml_content.strip().split('\n'):
if ':' in line and not line.startswith(' ') and not line.startswith('\t'):
if current_key:
frontmatter[current_key] = '\n'.join(current_value).strip().strip('"').strip("'")
key, _, value = line.partition(':')
current_key = key.strip()
current_value = [value.strip().strip('"').strip("'").strip('|')]
elif current_key:
current_value.append(line.strip())
if current_key:
frontmatter[current_key] = '\n'.join(current_value).strip()
return frontmatter, body
def extract_steps(body):
"""Trích xuất các bước từ Instructions section."""
steps = []
in_instructions = False
current_step = None
for line in body.split('\n'):
stripped = line.strip()
# Bắt đầu section Instructions
if re.match(r'^#{1,2}\s+Instructions', stripped, re.IGNORECASE):
in_instructions = True
continue
# Kết thúc section (gặp heading mới cùng level)
if in_instructions and re.match(r'^#{1,2}\s+(?!Bước|Step|Stage)', stripped):
if not re.match(r'^#{3,}', stripped):
break
if in_instructions:
# Tìm numbered step
step_match = re.match(r'^(\d+)\.\s+(.+)', stripped)
if step_match:
if current_step:
steps.append(current_step)
current_step = {
'number': int(step_match.group(1)),
'text': step_match.group(2),
'sub_steps': [],
'has_condition': False,
'has_action': False,
'has_error_handling': False,
}
elif current_step and stripped.startswith(('-', '*', '•')):
sub = stripped.lstrip('-*• ').strip()
current_step['sub_steps'].append(sub)
if current_step:
steps.append(current_step)
return steps
def extract_examples(body):
"""Trích xuất ví dụ từ Examples section."""
examples = []
in_examples = False
current_example = None
for line in body.split('\n'):
stripped = line.strip()
if re.match(r'^#{1,2}\s+Examples', stripped, re.IGNORECASE):
in_examples = True
continue
if in_examples and re.match(r'^#{1,2}\s+(?!Ví dụ|Example)', stripped):
if not re.match(r'^#{3,}', stripped):
break
if in_examples:
example_match = re.match(r'^#{2,3}\s+(?:Ví dụ|Example)\s*\d*[:.]\s*(.*)', stripped, re.IGNORECASE)
if example_match:
if current_example:
examples.append(current_example)
current_example = {
'title': example_match.group(1),
'has_input': False,
'has_output': False,
}
if current_example:
if re.match(r'\*\*Input', stripped, re.IGNORECASE):
current_example['has_input'] = True
if re.match(r'\*\*Output', stripped, re.IGNORECASE):
current_example['has_output'] = True
if current_example:
examples.append(current_example)
return examples
def extract_constraints(body):
"""Trích xuất constraints."""
constraints = []
in_constraints = False
for line in body.split('\n'):
stripped = line.strip()
if re.match(r'^#{1,2}\s+Constraints', stripped, re.IGNORECASE):
in_constraints = True
continue
if in_constraints and re.match(r'^#{1,2}\s+', stripped):
if not re.match(r'^#{3,}', stripped):
break
if in_constraints:
constraint_match = re.match(r'^[-*]\s+(.+)', stripped)
if constraint_match:
text = constraint_match.group(1)
is_negative = any(kw in text.upper() for kw in ['KHÔNG ĐƯỢC', 'KHÔNG BAO GIỜ', 'TUYỆT ĐỐI KHÔNG', 'NEVER', '🚫'])
is_positive = any(kw in text.upper() for kw in ['LUÔN LUÔN', 'ALWAYS', 'BẮT BUỘC', '✅'])
constraints.append({
'text': text,
'type': 'negative' if is_negative else ('positive' if is_positive else 'neutral'),
})
return constraints
# Danh sách từ mơ hồ cần cảnh báo
AMBIGUOUS_WORDS = [
('xử lý', 'parse/validate/transform/filter'),
('kiểm tra', 'so sánh X với Y / đảm bảo X ≥ 0'),
('tối ưu', 'giảm thời gian <2s / giảm bundle <500KB'),
('phù hợp', 'khớp regex / thuộc danh sách X'),
('tốt', 'pass test / response <200ms'),
('sạch', 'không duplicate / function <30 dòng'),
('nhiều', '≥5 items / >1000 rows'),
('lớn', '>10MB / >1000 records'),
('nhanh', '<2s / <100ms'),
]
def analyze_step(step):
"""Phân tích chất lượng 1 bước."""
issues = []
text = step['text'].lower()
all_text = text + ' ' + ' '.join(s.lower() for s in step['sub_steps'])
# Check conditional logic
step['has_condition'] = any(kw in all_text for kw in ['nếu', 'if', 'khi', 'when', 'trường hợp'])
# Check actionable
action_verbs = ['đọc', 'ghi', 'chạy', 'tạo', 'xóa', 'kiểm', 'gửi', 'parse', 'scan',
'hỏi', 'hiển thị', 'output', 'lưu', 'copy', 'move', 'validate',
'generate', 'deploy', 'build', 'test', 'review', 'format',
'trích xuất', 'phân tích', 'so sánh', 'merge', 'sort',
'kích hoạt', 'báo', 'cảnh báo', 'confirm', 'xác nhận']
step['has_action'] = any(verb in all_text for verb in action_verbs)
# Check error handling
error_keywords = ['lỗi', 'fail', 'error', 'exception', 'không tìm', 'không có',
'nếu fail', 'nếu lỗi', 'trường hợp xấu', 'fallback']
step['has_error_handling'] = any(kw in all_text for kw in error_keywords)
# Check ambiguous words
for word, suggestion in AMBIGUOUS_WORDS:
if word in text:
issues.append(f'Từ mơ hồ "{word}" → Nên cụ thể hơn: {suggestion}')
# Check too short
if len(step['text'].split()) < 4 and len(step['sub_steps']) == 0:
issues.append('Bước quá ngắn, thiếu chi tiết')
return issues
def simulate(skill_path):
"""Chạy mô phỏng toàn bộ skill."""
Colors.enable_windows()
path = Path(skill_path)
if path.is_dir():
path = path / 'SKILL.md'
if not path.exists():
print(f"{Colors.FAIL}❌ Không tìm thấy: {path}{Colors.RESET}")
return False
content = path.read_text(encoding='utf-8', errors='ignore')
frontmatter, body = parse_frontmatter(content)
steps = extract_steps(body)
examples = extract_examples(body)
constraints = extract_constraints(body)
print(f"\n{Colors.BOLD}{'='*60}{Colors.RESET}")
print(f"{Colors.BOLD}🧪 SKILL SIMULATOR — Mô phỏng chạy thử{Colors.RESET}")
print(f"{Colors.BOLD}{'='*60}{Colors.RESET}")
name = frontmatter.get('name', path.parent.name)
desc = frontmatter.get('description', '(không có)')
print(f"\n{Colors.INFO}📌 Skill: {name}{Colors.RESET}")
print(f"{Colors.DIM}📝 {desc[:100]}{'...' if len(desc) > 100 else ''}{Colors.RESET}\n")
# ---- Simulate Steps ----
print(f"{Colors.BOLD}🔄 DRY RUN — Đi qua từng bước:{Colors.RESET}\n")
total_issues = 0
actionable_steps = 0
conditional_steps = 0
error_handled_steps = 0
for step in steps:
issues = analyze_step(step)
total_issues += len(issues)
if step['has_action']:
actionable_steps += 1
if step['has_condition']:
conditional_steps += 1
if step['has_error_handling']:
error_handled_steps += 1
# Status icon
if issues:
icon = f"{Colors.WARN}⚠️{Colors.RESET}"
elif step['has_action']:
icon = f"{Colors.PASS}✅{Colors.RESET}"
else:
icon = f"{Colors.WARN}🔸{Colors.RESET}"
# Flags
flags = []
if step['has_condition']:
flags.append('🔀 Rẽ nhánh')
if step['has_error_handling']:
flags.append('🛡️ Error handling')
if not step['has_action']:
flags.append(f'{Colors.WARN}⚠️ Thiếu hành động cụ thể{Colors.RESET}')
flag_str = f" [{', '.join(flags)}]" if flags else ""
print(f" {icon} Bước {step['number']}: {step['text'][:70]}{flag_str}")
for sub in step['sub_steps'][:3]:
print(f" {Colors.DIM} └─ {sub[:65]}{Colors.RESET}")
for issue in issues:
print(f" {Colors.WARN} ⚠️ {issue}{Colors.RESET}")
print()
# ---- Examples Analysis ----
print(f"{Colors.BOLD}📋 Examples Analysis:{Colors.RESET}")
if examples:
for i, ex in enumerate(examples, 1):
input_icon = f"{Colors.PASS}✅{Colors.RESET}" if ex['has_input'] else f"{Colors.FAIL}❌{Colors.RESET}"
output_icon = f"{Colors.PASS}✅{Colors.RESET}" if ex['has_output'] else f"{Colors.FAIL}❌{Colors.RESET}"
print(f" Ví dụ {i}: {ex['title'][:50]}")
print(f" Input: {input_icon} Output: {output_icon}")
else:
print(f" {Colors.WARN}⚠️ Không tìm thấy ví dụ nào!{Colors.RESET}")
print()
# ---- Constraints Analysis ----
print(f"{Colors.BOLD}🚧 Constraints Analysis:{Colors.RESET}")
neg_count = sum(1 for c in constraints if c['type'] == 'negative')
pos_count = sum(1 for c in constraints if c['type'] == 'positive')
neu_count = sum(1 for c in constraints if c['type'] == 'neutral')
if constraints:
print(f" 🚫 Negative (KHÔNG ĐƯỢC): {neg_count}")
print(f" ✅ Positive (LUÔN LUÔN): {pos_count}")
print(f" 🔸 Neutral: {neu_count}")
else:
print(f" {Colors.WARN}⚠️ Không tìm thấy constraints!{Colors.RESET}")
print()
# ---- Overall Score ----
print(f"{Colors.BOLD}{'='*60}{Colors.RESET}")
print(f"{Colors.BOLD}📊 SIMULATION REPORT:{Colors.RESET}\n")
metrics = [
('Tổng bước', len(steps), None),
('Bước có hành động cụ thể', actionable_steps, len(steps)),
('Bước có logic rẽ nhánh', conditional_steps, None),
('Bước có error handling', error_handled_steps, len(steps)),
('Ví dụ có Input+Output', sum(1 for e in examples if e['has_input'] and e['has_output']), len(examples)),
('Constraints (negative)', neg_count, None),
('Issues phát hiện', total_issues, None),
]
for label, value, total in metrics:
if total:
pct = value / total * 100 if total > 0 else 0
color = Colors.PASS if pct >= 80 else Colors.WARN if pct >= 50 else Colors.FAIL
print(f" {color}{label}: {value}/{total} ({pct:.0f}%){Colors.RESET}")
else:
print(f" {Colors.INFO}{label}: {value}{Colors.RESET}")
# Grade
print()
score = 0
if len(steps) > 0:
score += min(30, actionable_steps / len(steps) * 30) # 30 pts for actionable
score += min(20, error_handled_steps / len(steps) * 20) # 20 pts for error handling
score += min(20, len(examples) * 10) # 20 pts for examples (2=full)
score += min(15, neg_count * 5) # 15 pts for constraints
score -= total_issues * 3 # -3 pts per issue
score = max(0, min(100, score))
if score >= 90:
grade, msg = 'A+', '🏆 Skill mô phỏng hoàn hảo!'
elif score >= 80:
grade, msg = 'A', '👍 Skill rất tốt, sẵn sàng deploy!'
elif score >= 65:
grade, msg = 'B', '⚠️ Khá tốt, cần cải thiện một số bước.'
elif score >= 50:
grade, msg = 'C', '⚠️ Cần sửa đáng kể trước khi deploy.'
else:
grade, msg = 'F', '❌ Cần viết lại phần lớn skill.'
color = Colors.PASS if score >= 80 else Colors.WARN if score >= 50 else Colors.FAIL
print(f" {color}{Colors.BOLD}Score: {score:.0f}/100 — Grade: {grade}{Colors.RESET}")
print(f" {color}{msg}{Colors.RESET}")
print(f"\n{Colors.BOLD}{'='*60}{Colors.RESET}\n")
return score >= 65
if __name__ == '__main__':
if len(sys.argv) < 2:
print("Sử dụng: python simulate_skill.py <path-to-SKILL.md-or-skill-folder>")
print("Ví dụ: python simulate_skill.py ./my-skill/")
sys.exit(1)
target = sys.argv[1]
if not os.path.exists(target):
print(f"❌ Không tìm thấy: {target}")
sys.exit(1)
success = simulate(target)
sys.exit(0 if success else 1)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |