@jhm1909/ag-kit 0.1.0

package/.agent/skills/project-manager/scripts/init_skill.py

@@ -0,0 +1,190 @@
+#!/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-skill --path .agent/skills        # Workspace skill
+    init_skill.py my-skill --path ~/.gemini/skills     # Global skill
+"""
+
+import sys
+from pathlib import Path
+
+from encoding_utils import configure_utf8_console, write_text_utf8
+
+configure_utf8_console()
+
+
+SKILL_TEMPLATE = """---
+name: {skill_name}
+description: [TODO: Describe what this skill does and when to use it. Include trigger keywords. 1-1024 chars]
+# license: MIT
+# compatibility: [Optional: environment requirements, 1-500 chars]
+# metadata:
+#   author: your-name
+#   version: "1.0"
+# allowed-tools: [Experimental: pre-approved tools list]
+---
+
+# {skill_title}
+
+[TODO: 1-2 sentences explaining what this skill enables]
+
+## Workflow
+
+[TODO: Step-by-step instructions for the agent]
+
+1. **Step 1**: Description
+2. **Step 2**: Description
+3. **Step 3**: Description
+
+## Examples
+
+[TODO: Concrete examples with realistic user requests]
+
+## Resources
+
+- `scripts/` - Executable scripts for automation
+- `references/` - Documentation loaded as needed
+- `assets/` - Templates and files for output
+
+Delete unused directories.
+"""
+
+EXAMPLE_SCRIPT = '''#!/usr/bin/env python3
+"""
+Example script for {skill_name}
+
+Replace with actual implementation or delete if not needed.
+"""
+
+def main():
+    print("Example script for {skill_name}")
+    # TODO: Add actual logic
+
+if __name__ == "__main__":
+    main()
+'''
+
+EXAMPLE_REFERENCE = """# Reference: {skill_title}
+
+[TODO: Add detailed documentation here]
+
+## API Reference
+
+[Document endpoints, functions, or schemas]
+
+## Examples
+
+[Provide code examples and usage patterns]
+"""
+
+EXAMPLE_ASSET = """# Asset Placeholder
+
+Replace with actual assets (templates, images, fonts, etc.) or delete this file.
+
+Common asset types:
+- Templates: .pptx, .docx, boilerplate directories
+- Images: .png, .jpg, .svg
+- Data: .csv, .json, .yaml
+"""
+
+
+def title_case_skill_name(skill_name):
+    """Convert hyphenated skill name to Title Case."""
+    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."""
+    skill_dir = Path(path).resolve() / skill_name
+
+    if skill_dir.exists():
+        print(f"❌ Error: Directory already exists: {skill_dir}")
+        return None
+
+    try:
+        skill_dir.mkdir(parents=True, exist_ok=False)
+        print(f"✅ Created: {skill_dir}")
+    except Exception as e:
+        print(f"❌ Error creating directory: {e}")
+        return None
+
+    # Create SKILL.md
+    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:
+        write_text_utf8(skill_md_path, skill_content)
+        print("✅ Created SKILL.md")
+    except Exception as e:
+        print(f"❌ Error creating SKILL.md: {e}")
+        return None
+
+    # Create resource directories with examples
+    try:
+        # scripts/
+        scripts_dir = skill_dir / 'scripts'
+        scripts_dir.mkdir(exist_ok=True)
+        example_script = scripts_dir / 'example.py'
+        write_text_utf8(example_script, EXAMPLE_SCRIPT.format(skill_name=skill_name))
+        example_script.chmod(0o755)
+        print("✅ Created scripts/example.py")
+
+        # references/
+        references_dir = skill_dir / 'references'
+        references_dir.mkdir(exist_ok=True)
+        example_ref = references_dir / 'reference.md'
+        write_text_utf8(example_ref, EXAMPLE_REFERENCE.format(skill_title=skill_title))
+        print("✅ Created references/reference.md")
+
+        # assets/
+        assets_dir = skill_dir / 'assets'
+        assets_dir.mkdir(exist_ok=True)
+        example_asset = assets_dir / 'README.md'
+        write_text_utf8(example_asset, EXAMPLE_ASSET)
+        print("✅ Created assets/README.md")
+    except Exception as e:
+        print(f"❌ Error creating resources: {e}")
+        return None
+
+    print(f"\n✅ Skill '{skill_name}' initialized at {skill_dir}")
+    print("\nNext steps:")
+    print("1. Edit SKILL.md to complete TODO items")
+    print("2. Customize or delete example files")
+    print("3. Run: python scripts/quick_validate.py <skill-path>")
+
+    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("  - 1-64 characters")
+        print("  - Lowercase letters, digits, and hyphens only")
+        print("  - No starting/ending hyphens, no consecutive hyphens")
+        print("\nExamples:")
+        print("  init_skill.py my-skill --path .agent/skills")
+        print("  init_skill.py my-skill --path ~/.gemini/skills")
+        sys.exit(1)
+
+    skill_name = sys.argv[1]
+    path = sys.argv[3]
+
+    print(f"🚀 Initializing skill: {skill_name}")
+    print(f"   Location: {path}\n")
+
+    result = init_skill(skill_name, path)
+    sys.exit(0 if result else 1)
+
+
+if __name__ == "__main__":
+    main()

package/.agent/skills/project-manager/scripts/quick_validate.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""
+Skill Validator - Validates skill structure per Agent Skills spec
+
+Usage:
+    python quick_validate.py <skill_directory>
+
+Validates:
+    - SKILL.md exists with valid YAML frontmatter
+    - name: 1-64 chars, lowercase alphanumeric + hyphens, matches directory
+    - description: 1-1024 chars, no angle brackets
+    - Optional fields: license, compatibility (1-500 chars), metadata
+"""
+
+import sys
+import re
+from pathlib import Path
+
+from encoding_utils import configure_utf8_console, read_text_utf8
+
+configure_utf8_console()
+
+
+def validate_skill(skill_path):
+    """Validate a skill against Agent Skills specification."""
+    skill_path = Path(skill_path)
+    errors = []
+    warnings = []
+
+    # Check SKILL.md exists
+    skill_md = skill_path / 'SKILL.md'
+    if not skill_md.exists():
+        return False, "SKILL.md not found", []
+
+    content = read_text_utf8(skill_md)
+
+    # Check frontmatter exists
+    if not content.startswith('---'):
+        return False, "No YAML frontmatter found (must start with ---)", []
+
+    # Extract frontmatter
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return False, "Invalid frontmatter format (missing closing ---)", []
+
+    frontmatter = match.group(1)
+
+    # Validate name field (required)
+    name_match = re.search(r'^name:\s*(.+)$', frontmatter, re.MULTILINE)
+    if not name_match:
+        errors.append("Missing required 'name' field")
+    else:
+        name = name_match.group(1).strip()
+        
+        # Length check: 1-64 characters
+        if len(name) < 1 or len(name) > 64:
+            errors.append(f"Name '{name}' must be 1-64 characters (got {len(name)})")
+        
+        # Format check: lowercase alphanumeric + hyphens
+        if not re.match(r'^[a-z0-9-]+$', name):
+            errors.append(f"Name '{name}' must be lowercase alphanumeric with hyphens only")
+        
+        # No invalid hyphen patterns
+        if name.startswith('-') or name.endswith('-'):
+            errors.append(f"Name '{name}' cannot start or end with hyphen")
+        if '--' in name:
+            errors.append(f"Name '{name}' cannot contain consecutive hyphens")
+        
+        # Must match directory name
+        if name != skill_path.name:
+            errors.append(f"Name '{name}' must match directory name '{skill_path.name}'")
+
+    # Validate description field (required)
+    desc_match = re.search(r'^description:\s*(.+)$', frontmatter, re.MULTILINE)
+    if not desc_match:
+        errors.append("Missing required 'description' field")
+    else:
+        description = desc_match.group(1).strip()
+        
+        # Length check: 1-1024 characters
+        if len(description) < 1:
+            errors.append("Description cannot be empty")
+        elif len(description) > 1024:
+            errors.append(f"Description exceeds 1024 characters (got {len(description)})")
+        
+        # No angle brackets (common mistake)
+        if '<' in description or '>' in description:
+            errors.append("Description cannot contain angle brackets (< or >)")
+        
+        # Warning for short descriptions
+        if len(description) < 50:
+            warnings.append(f"Description is short ({len(description)} chars). Consider adding more detail.")
+
+    # Validate optional compatibility field
+    compat_match = re.search(r'^compatibility:\s*(.+)$', frontmatter, re.MULTILINE)
+    if compat_match:
+        compatibility = compat_match.group(1).strip()
+        if len(compatibility) > 500:
+            errors.append(f"Compatibility exceeds 500 characters (got {len(compatibility)})")
+
+    if errors:
+        return False, "; ".join(errors), warnings
+
+    return True, "Skill is valid!", warnings
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+
+    valid, message, warnings = validate_skill(sys.argv[1])
+    
+    if warnings:
+        for w in warnings:
+            print(f"⚠️  Warning: {w}")
+    
+    if valid:
+        print(f"✅ {message}")
+    else:
+        print(f"❌ {message}")
+    
+    sys.exit(0 if valid else 1)

package/.agent/skills/project-manager/templates/pm-strategy-one-pager.md

@@ -0,0 +1,6 @@
+# Opportunity: [Name]
+
+**Why now?**: Market trend / Competitor move / User demand.
+**Value**: $XM ARR opportunity or X% churn reduction.
+**Cost**: Estimated [T-Shirt Size] (Small/Med/Large) effort.
+**Risk**: High/Med/Low.

package/.agent/skills/project-manager/templates/prd-strategic.md

@@ -0,0 +1,38 @@
+# [PRD] Title of Feature
+
+**Status**: Draft | In Review | Approved
+**Owner**: @PM
+**Date**: YYYY-MM-DD
+
+## 1. Context & Goal
+
+- **Problem**: What user problem are we solving? "As a [user], I cannot [action] because [roadblock]."
+- **Goal**: What does success look like? (e.g., reduce support tickets by 20%)
+- **Hypothesis**: If we build X, then Y will happen.
+
+## 2. User Stories (Agile)
+
+| ID   | Story                                                    | Acceptance Criteria              | Priority |
+| ---- | -------------------------------------------------------- | -------------------------------- | -------- |
+| US-1 | As a [role], I want to [action] so that [distinct value] | 1. Criterion A<br>2. Criterion B | Must     |
+| US-2 | ...                                                      | ...                              | Should   |
+
+## 3. Scope (In/Out)
+
+- **In Scope**: Feature A, Feature B.
+- **Out of Scope**: Mobile support (Phase 2), Localization.
+
+## 4. Design & UX
+
+- [Link to Figma/Mockups]
+- Key Flows: Login -> Dashboard -> Settings.
+
+## 5. Technical Constraints
+
+- API latency requirements.
+- Security/Permission requirements.
+
+## 6. Analytics & Success Metrics
+
+- **Primary Metric**: Conversion Rate.
+- **Guardrail Metric**: Page Load Time.

package/.agent/skills/project-manager/templates/skill-questionnaire.md

@@ -0,0 +1,118 @@
+# Skill Requirements Questionnaire
+
+> **For Agent:** This is a BASE TEMPLATE. You MUST customize with domain-specific questions before giving to user.
+>
+> **For User:** Fill in this form to help define your skill requirements clearly.
+> Delete examples and replace with your answers.
+
+---
+
+## Phase 1: Discovery (WHY & WHO)
+
+### What specific problem needs to be solved?
+
+<!-- Example: "I need a skill that helps write consistent unit tests for React components" -->
+
+### Who will use this skill?
+
+<!-- Options: agent, human, or both -->
+
+### What triggers the need to create/upgrade this skill?
+
+<!-- Example: "Current testing workflow is inconsistent across the team" -->
+
+---
+
+## Phase 2: Context (WHAT & WHERE)
+
+### What is the specific domain?
+
+<!-- Options: frontend, backend, devops, AI, blockchain, mobile, etc. -->
+
+### What tech stack or frameworks are involved?
+
+<!-- Example: "React, Jest, Testing Library, TypeScript" -->
+
+### What constraints must be followed?
+
+<!-- Example: "Must work with existing CI/CD pipeline, team of 5 developers" -->
+
+---
+
+## Phase 3: Scope (BOUNDARIES)
+
+### What is IN scope?
+
+<!-- List specific features/capabilities the skill MUST have -->
+
+-
+-
+-
+
+### What is OUT of scope?
+
+<!-- List what the skill should NOT handle -->
+
+-
+-
+-
+
+### Upgrade type (for existing skills only)
+
+<!-- Options: Minor Update / Major Upgrade / Restructure -->
+
+### Dependencies with other skills/tools?
+
+<!-- List any skills or tools this should integrate with -->
+
+---
+
+## Phase 4: Quality (STANDARDS)
+
+### What level of expertise should this skill embody?
+
+<!-- Options: junior, senior, expert (20+ years) -->
+
+### Design Principle: Separation of Concerns
+
+<!-- Reminder:
+- Skill = Knowledge (Capabilities, Standards, Best Practices)
+- Workflow = Process (Steps, Sequences, Lifecycles)
+Do NOT ask for "Process" definitions here. Focus on "Knowledge".
+-->
+
+### Which best practices must be followed?
+
+<!-- Example: "Follow Testing Trophy pattern, AAA structure for tests" -->
+
+### What edge cases need to be handled?
+
+<!-- List specific edge cases or error scenarios -->
+
+-
+-
+- ***
+
+## Phase 5: Validation (SUCCESS CRITERIA)
+
+### What are the acceptance criteria?
+
+<!-- List specific, measurable criteria for success -->
+
+- [ ]
+- [ ]
+- [ ]
+
+### How do we know the skill works correctly?
+
+<!-- Example: "Successfully generates tests that pass CI, covers >80% of cases" -->
+
+### What metrics measure improvement?
+
+<!-- Example: "Time to write tests reduced by 50%, test coverage increased" -->
+
+---
+
+## Additional Notes
+
+<!-- Any other context, examples, or references that would help -->

package/.agent/skills/project-manager/templates/user-story-simple.md

@@ -0,0 +1,14 @@
+**Title**: [Action] - [Persona]
+**Story**: As a **Guest User**, I want to **view specific product details** so that I can **make a purchase decision**.
+
+**Acceptance Criteria**:
+
+1.  [ ] Clicking "View" on a product card opens the detail page.
+2.  [ ] Detail page shows Price, Title, Description, and "Add to Cart".
+3.  [ ] If product is OOS, "Add to Cart" is disabled.
+
+**Definition of Done**:
+
+- Unit tests passed.
+- UI matches Figma.
+- Accessibility tags checked.