@agenthippo-ai/agenthippo 1.110.9 → 1.110.19

package/out/base-prompts/skills/skill-creator/references/workflows.md

@@ -1,28 +0,0 @@
-# Workflow Patterns
-
-## Sequential Workflows
-
-For complex tasks, break operations into clear, sequential steps. It is often helpful to give Claude an overview of the process towards the beginning of SKILL.md:
-
-```markdown
-Filling a PDF form involves these steps:
-
-1. Analyze the form (run analyze_form.py)
-2. Create field mapping (edit fields.json)
-3. Validate mapping (run validate_fields.py)
-4. Fill the form (run fill_form.py)
-5. Verify output (run verify_output.py)
-```
-
-## Conditional Workflows
-
-For tasks with branching logic, guide Claude through decision points:
-
-```markdown
-1. Determine the modification type:
-   **Creating new content?** → Follow "Creation workflow" below
-   **Editing existing content?** → Follow "Editing workflow" below
-
-2. Creation workflow: [steps]
-3. Editing workflow: [steps]
-```

package/out/base-prompts/skills/skill-creator/scripts/init_skill.py

@@ -1,303 +0,0 @@
-#!/usr/bin/env python3
-"""
-Skill Initializer - Creates a new skill from template
-
-Usage:
-	init_skill.py <skill-name> --path <path>
-
-Examples:
-	init_skill.py my-new-skill --path skills/public
-	init_skill.py my-api-helper --path skills/private
-	init_skill.py custom-skill --path /custom/location
-"""
-
-import sys
-from pathlib import Path
-
-
-SKILL_TEMPLATE = """---
-name: {skill_name}
-description: [TODO: Complete and informative explanation of what the skill does and when to use it. Include WHEN to use this skill - specific scenarios, file types, or tasks that trigger it.]
----
-
-# {skill_title}
-
-## Overview
-
-[TODO: 1-2 sentences explaining what this skill enables]
-
-## Structuring This Skill
-
-[TODO: Choose the structure that best fits this skill's purpose. Common patterns:
-
-**1. Workflow-Based** (best for sequential processes)
-- Works well when there are clear step-by-step procedures
-- Example: DOCX skill with "Workflow Decision Tree" → "Reading" → "Creating" → "Editing"
-- Structure: ## Overview → ## Workflow Decision Tree → ## Step 1 → ## Step 2...
-
-**2. Task-Based** (best for tool collections)
-- Works well when the skill offers different operations/capabilities
-- Example: PDF skill with "Quick Start" → "Merge PDFs" → "Split PDFs" → "Extract Text"
-- Structure: ## Overview → ## Quick Start → ## Task Category 1 → ## Task Category 2...
-
-**3. Reference/Guidelines** (best for standards or specifications)
-- Works well for brand guidelines, coding standards, or requirements
-- Example: Brand styling with "Brand Guidelines" → "Colors" → "Typography" → "Features"
-- Structure: ## Overview → ## Guidelines → ## Specifications → ## Usage...
-
-**4. Capabilities-Based** (best for integrated systems)
-- Works well when the skill provides multiple interrelated features
-- Example: Product Management with "Core Capabilities" → numbered capability list
-- Structure: ## Overview → ## Core Capabilities → ### 1. Feature → ### 2. Feature...
-
-Patterns can be mixed and matched as needed. Most skills combine patterns (e.g., start with task-based, add workflow for complex operations).
-
-Delete this entire "Structuring This Skill" section when done - it's just guidance.]
-
-## [TODO: Replace with the first main section based on chosen structure]
-
-[TODO: Add content here. See examples in existing skills:
-- Code samples for technical skills
-- Decision trees for complex workflows
-- Concrete examples with realistic user requests
-- References to scripts/templates/references as needed]
-
-## Resources
-
-This skill includes example resource directories that demonstrate how to organize different types of bundled resources:
-
-### scripts/
-Executable code (Python/Bash/etc.) that can be run directly to perform specific operations.
-
-**Examples from other skills:**
-- PDF skill: `fill_fillable_fields.py`, `extract_form_field_info.py` - utilities for PDF manipulation
-- DOCX skill: `document.py`, `utilities.py` - Python modules for document processing
-
-**Appropriate for:** Python scripts, shell scripts, or any executable code that performs automation, data processing, or specific operations.
-
-**Note:** Scripts may be executed without loading into context, but can still be read by Claude for patching or environment adjustments.
-
-### references/
-Documentation and reference material intended to be loaded into context to inform Claude's process and thinking.
-
-**Examples from other skills:**
-- Product management: `communication.md`, `context_building.md` - detailed workflow guides
-- BigQuery: API reference documentation and query examples
-- Finance: Schema documentation, company policies
-
-**Appropriate for:** In-depth documentation, API references, database schemas, comprehensive guides, or any detailed information that Claude should reference while working.
-
-### assets/
-Files not intended to be loaded into context, but rather used within the output Claude produces.
-
-**Examples from other skills:**
-- Brand styling: PowerPoint template files (.pptx), logo files
-- Frontend builder: HTML/React boilerplate project directories
-- Typography: Font files (.ttf, .woff2)
-
-**Appropriate for:** Templates, boilerplate code, document templates, images, icons, fonts, or any files meant to be copied or used in the final output.
-
----
-
-**Any unneeded directories can be deleted.** Not every skill requires all three types of resources.
-"""
-
-EXAMPLE_SCRIPT = '''#!/usr/bin/env python3
-"""
-Example helper script for {skill_name}
-
-This is a placeholder script that can be executed directly.
-Replace with actual implementation or delete if not needed.
-
-Example real scripts from other skills:
-- pdf/scripts/fill_fillable_fields.py - Fills PDF form fields
-- pdf/scripts/convert_pdf_to_images.py - Converts PDF pages to images
-"""
-
-def main():
-	print("This is an example script for {skill_name}")
-	# TODO: Add actual script logic here
-	# This could be data processing, file conversion, API calls, etc.
-
-if __name__ == "__main__":
-	main()
-'''
-
-EXAMPLE_REFERENCE = """# Reference Documentation for {skill_title}
-
-This is a placeholder for detailed reference documentation.
-Replace with actual reference content or delete if not needed.
-
-Example real reference docs from other skills:
-- product-management/references/communication.md - Comprehensive guide for status updates
-- product-management/references/context_building.md - Deep-dive on gathering context
-- bigquery/references/ - API references and query examples
-
-## When Reference Docs Are Useful
-
-Reference docs are ideal for:
-- Comprehensive API documentation
-- Detailed workflow guides
-- Complex multi-step processes
-- Information too lengthy for main SKILL.md
-- Content that's only needed for specific use cases
-
-## Structure Suggestions
-
-### API Reference Example
-- Overview
-- Authentication
-- Endpoints with examples
-- Error codes
-- Rate limits
-
-### Workflow Guide Example
-- Prerequisites
-- Step-by-step instructions
-- Common patterns
-- Troubleshooting
-- Best practices
-"""
-
-EXAMPLE_ASSET = """# Example Asset File
-
-This placeholder represents where asset files would be stored.
-Replace with actual asset files (templates, images, fonts, etc.) or delete if not needed.
-
-Asset files are NOT intended to be loaded into context, but rather used within
-the output Claude produces.
-
-Example asset files from other skills:
-- Brand guidelines: logo.png, slides_template.pptx
-- Frontend builder: hello-world/ directory with HTML/React boilerplate
-- Typography: custom-font.ttf, font-family.woff2
-- Data: sample_data.csv, test_dataset.json
-
-## Common Asset Types
-
-- Templates: .pptx, .docx, boilerplate directories
-- Images: .png, .jpg, .svg, .gif
-- Fonts: .ttf, .otf, .woff, .woff2
-- Boilerplate code: Project directories, starter files
-- Icons: .ico, .svg
-- Data files: .csv, .json, .xml, .yaml
-
-Note: This is a text placeholder. Actual assets can be any file type.
-"""
-
-
-def title_case_skill_name(skill_name):
-	"""Convert hyphenated skill name to Title Case for display."""
-	return ' '.join(word.capitalize() for word in skill_name.split('-'))
-
-
-def init_skill(skill_name, path):
-	"""
-	Initialize a new skill directory with template SKILL.md.
-
-	Args:
-		skill_name: Name of the skill
-		path: Path where the skill directory should be created
-
-	Returns:
-		Path to created skill directory, or None if error
-	"""
-	# Determine skill directory path
-	skill_dir = Path(path).resolve() / skill_name
-
-	# Check if directory already exists
-	if skill_dir.exists():
-		print(f"❌ Error: Skill directory already exists: {skill_dir}")
-		return None
-
-	# Create skill directory
-	try:
-		skill_dir.mkdir(parents=True, exist_ok=False)
-		print(f"✅ Created skill directory: {skill_dir}")
-	except Exception as e:
-		print(f"❌ Error creating directory: {e}")
-		return None
-
-	# Create SKILL.md from template
-	skill_title = title_case_skill_name(skill_name)
-	skill_content = SKILL_TEMPLATE.format(
-		skill_name=skill_name,
-		skill_title=skill_title
-	)
-
-	skill_md_path = skill_dir / 'SKILL.md'
-	try:
-		skill_md_path.write_text(skill_content)
-		print("✅ Created SKILL.md")
-	except Exception as e:
-		print(f"❌ Error creating SKILL.md: {e}")
-		return None
-
-	# Create resource directories with example files
-	try:
-		# Create scripts/ directory with example script
-		scripts_dir = skill_dir / 'scripts'
-		scripts_dir.mkdir(exist_ok=True)
-		example_script = scripts_dir / 'example.py'
-		example_script.write_text(EXAMPLE_SCRIPT.format(skill_name=skill_name))
-		example_script.chmod(0o755)
-		print("✅ Created scripts/example.py")
-
-		# Create references/ directory with example reference doc
-		references_dir = skill_dir / 'references'
-		references_dir.mkdir(exist_ok=True)
-		example_reference = references_dir / 'api_reference.md'
-		example_reference.write_text(EXAMPLE_REFERENCE.format(skill_title=skill_title))
-		print("✅ Created references/api_reference.md")
-
-		# Create assets/ directory with example asset placeholder
-		assets_dir = skill_dir / 'assets'
-		assets_dir.mkdir(exist_ok=True)
-		example_asset = assets_dir / 'example_asset.txt'
-		example_asset.write_text(EXAMPLE_ASSET)
-		print("✅ Created assets/example_asset.txt")
-	except Exception as e:
-		print(f"❌ Error creating resource directories: {e}")
-		return None
-
-	# Print next steps
-	print(f"\n✅ Skill '{skill_name}' initialized successfully at {skill_dir}")
-	print("\nNext steps:")
-	print("1. Edit SKILL.md to complete the TODO items and update the description")
-	print("2. Customize or delete the example files in scripts/, references/, and assets/")
-	print("3. Run the validator when ready to check the skill structure")
-
-	return skill_dir
-
-
-def main():
-	if len(sys.argv) < 4 or sys.argv[2] != '--path':
-		print("Usage: init_skill.py <skill-name> --path <path>")
-		print("\nSkill name requirements:")
-		print("  - Hyphen-case identifier (e.g., 'data-analyzer')")
-		print("  - Lowercase letters, digits, and hyphens only")
-		print("  - Max 40 characters")
-		print("  - Must match directory name exactly")
-		print("\nExamples:")
-		print("  init_skill.py my-new-skill --path skills/public")
-		print("  init_skill.py my-api-helper --path skills/private")
-		print("  init_skill.py custom-skill --path /custom/location")
-		sys.exit(1)
-
-	skill_name = sys.argv[1]
-	path = sys.argv[3]
-
-	print(f"🚀 Initializing skill: {skill_name}")
-	print(f"   Location: {path}")
-	print()
-
-	result = init_skill(skill_name, path)
-
-	if result:
-		sys.exit(0)
-	else:
-		sys.exit(1)
-
-
-if __name__ == "__main__":
-	main()

package/out/base-prompts/skills/skill-creator/scripts/package_skill.py

@@ -1,110 +0,0 @@
-#!/usr/bin/env python3
-"""
-Skill Packager - Creates a distributable .skill file of a skill folder
-
-Usage:
-	python utils/package_skill.py <path/to/skill-folder> [output-directory]
-
-Example:
-	python utils/package_skill.py skills/public/my-skill
-	python utils/package_skill.py skills/public/my-skill ./dist
-"""
-
-import sys
-import zipfile
-from pathlib import Path
-from quick_validate import validate_skill
-
-
-def package_skill(skill_path, output_dir=None):
-	"""
-	Package a skill folder into a .skill file.
-
-	Args:
-		skill_path: Path to the skill folder
-		output_dir: Optional output directory for the .skill file (defaults to current directory)
-
-	Returns:
-		Path to the created .skill file, or None if error
-	"""
-	skill_path = Path(skill_path).resolve()
-
-	# Validate skill folder exists
-	if not skill_path.exists():
-		print(f"❌ Error: Skill folder not found: {skill_path}")
-		return None
-
-	if not skill_path.is_dir():
-		print(f"❌ Error: Path is not a directory: {skill_path}")
-		return None
-
-	# Validate SKILL.md exists
-	skill_md = skill_path / "SKILL.md"
-	if not skill_md.exists():
-		print(f"❌ Error: SKILL.md not found in {skill_path}")
-		return None
-
-	# Run validation before packaging
-	print("🔍 Validating skill...")
-	valid, message = validate_skill(skill_path)
-	if not valid:
-		print(f"❌ Validation failed: {message}")
-		print("   Please fix the validation errors before packaging.")
-		return None
-	print(f"✅ {message}\n")
-
-	# Determine output location
-	skill_name = skill_path.name
-	if output_dir:
-		output_path = Path(output_dir).resolve()
-		output_path.mkdir(parents=True, exist_ok=True)
-	else:
-		output_path = Path.cwd()
-
-	skill_filename = output_path / f"{skill_name}.skill"
-
-	# Create the .skill file (zip format)
-	try:
-		with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
-			# Walk through the skill directory
-			for file_path in skill_path.rglob('*'):
-				if file_path.is_file():
-					# Calculate the relative path within the zip
-					arcname = file_path.relative_to(skill_path.parent)
-					zipf.write(file_path, arcname)
-					print(f"  Added: {arcname}")
-
-		print(f"\n✅ Successfully packaged skill to: {skill_filename}")
-		return skill_filename
-
-	except Exception as e:
-		print(f"❌ Error creating .skill file: {e}")
-		return None
-
-
-def main():
-	if len(sys.argv) < 2:
-		print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
-		print("\nExample:")
-		print("  python utils/package_skill.py skills/public/my-skill")
-		print("  python utils/package_skill.py skills/public/my-skill ./dist")
-		sys.exit(1)
-
-	skill_path = sys.argv[1]
-	output_dir = sys.argv[2] if len(sys.argv) > 2 else None
-
-	print(f"📦 Packaging skill: {skill_path}")
-	if output_dir:
-		print(f"   Output directory: {output_dir}")
-	print()
-
-	result = package_skill(skill_path, output_dir)
-
-	if result:
-		sys.exit(0)
-	else:
-		sys.exit(1)
-
-
-if __name__ == "__main__":
-	main()

package/out/base-prompts/skills/skill-creator/scripts/quick_validate.py

@@ -1,95 +0,0 @@
-#!/usr/bin/env python3
-"""
-Quick validation script for skills - minimal version
-"""
-
-import sys
-import os
-import re
-import yaml
-from pathlib import Path
-
-def validate_skill(skill_path):
-	"""Basic validation of a skill"""
-	skill_path = Path(skill_path)
-
-	# Check SKILL.md exists
-	skill_md = skill_path / 'SKILL.md'
-	if not skill_md.exists():
-		return False, "SKILL.md not found"
-
-	# Read and validate frontmatter
-	content = skill_md.read_text()
-	if not content.startswith('---'):
-		return False, "No YAML frontmatter found"
-
-	# Extract frontmatter
-	match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
-	if not match:
-		return False, "Invalid frontmatter format"
-
-	frontmatter_text = match.group(1)
-
-	# Parse YAML frontmatter
-	try:
-		frontmatter = yaml.safe_load(frontmatter_text)
-		if not isinstance(frontmatter, dict):
-			return False, "Frontmatter must be a YAML dictionary"
-	except yaml.YAMLError as e:
-		return False, f"Invalid YAML in frontmatter: {e}"
-
-	# Define allowed properties
-	ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata'}
-
-	# Check for unexpected properties (excluding nested keys under metadata)
-	unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES
-	if unexpected_keys:
-		return False, (
-			f"Unexpected key(s) in SKILL.md frontmatter: {', '.join(sorted(unexpected_keys))}. "
-			f"Allowed properties are: {', '.join(sorted(ALLOWED_PROPERTIES))}"
-		)
-
-	# Check required fields
-	if 'name' not in frontmatter:
-		return False, "Missing 'name' in frontmatter"
-	if 'description' not in frontmatter:
-		return False, "Missing 'description' in frontmatter"
-
-	# Extract name for validation
-	name = frontmatter.get('name', '')
-	if not isinstance(name, str):
-		return False, f"Name must be a string, got {type(name).__name__}"
-	name = name.strip()
-	if name:
-		# Check naming convention (hyphen-case: lowercase with hyphens)
-		if not re.match(r'^[a-z0-9-]+$', name):
-			return False, f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)"
-		if name.startswith('-') or name.endswith('-') or '--' in name:
-			return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens"
-		# Check name length (max 64 characters per spec)
-		if len(name) > 64:
-			return False, f"Name is too long ({len(name)} characters). Maximum is 64 characters."
-
-	# Extract and validate description
-	description = frontmatter.get('description', '')
-	if not isinstance(description, str):
-		return False, f"Description must be a string, got {type(description).__name__}"
-	description = description.strip()
-	if description:
-		# Check for angle brackets
-		if '<' in description or '>' in description:
-			return False, "Description cannot contain angle brackets (< or >)"
-		# Check description length (max 1024 characters per spec)
-		if len(description) > 1024:
-			return False, f"Description is too long ({len(description)} characters). Maximum is 1024 characters."
-
-	return True, "Skill is valid!"
-
-if __name__ == "__main__":
-	if len(sys.argv) != 2:
-		print("Usage: python quick_validate.py <skill_directory>")
-		sys.exit(1)
-	
-	valid, message = validate_skill(sys.argv[1])
-	print(message)
-	sys.exit(0 if valid else 1)