tools-only Sprint Context: Skill-Agent Integration Phase 1-2
Sprint ID: sprint-11-05-2025 Sprint Name: Skill-Agent Integration Foundation Start Date: November 5, 2025 Target End Date: November 19, 2025 Duration: 14 days (2 weeks) Sprint Type: Foundation Build
Sprint Goal
Primary Goal: Build the foundational agent integration system for claude-code-skills, enabling users to invoke specialized cs-* agents that seamlessly integrate with the existing 42 production skills.
Success Criteria:
- ✅ Root-level directory structure created (agents/, commands/, standards/, templates/)
- ✅ 5 core standards ported from factory and adapted
- ✅ 5 agents fully implemented (cs-content-creator, cs-demand-gen-specialist, cs-ceo-advisor, cs-cto-advisor, cs-product-manager)
- ✅ Agent template and creation guide complete
- ✅ All relative paths resolve correctly
- ✅ Python tools execute successfully from agent context
- ✅ Documentation updated (README, INSTALL, USAGE, CLAUDE)
- ✅ All quality gates pass
Context & Background
Why This Sprint?
The claude-code-skills repository currently contains 42 production-ready skills across 6 domains (marketing, C-level advisory, product team, project management, engineering, RA/QM). Each skill includes Python automation tools, knowledge bases, and templates.
Current Gap:
- Skills exist as standalone packages
- No orchestration layer for workflows
- Users must manually invoke Python scripts
- No guided workflows or best practices
Solution: Agent integration provides a workflow orchestration layer where specialized agents (cs-* prefix) invoke skills, coordinate Python tools, and guide users through complex multi-step processes.
Strategic Value
- User Experience: Transform from "tool collection" to "guided workflows"
- Marketplace Ready: Foundation for Anthropic plugin marketplace distribution
- Scalability: Template system enables rapid expansion to 42+ agents
- Differentiation: Only skill library with built-in agent orchestration
Scope
In Scope (Phase 1-2)
Phase 1: Core Structure (Days 1)
- Root-level directory creation
- Standards library (5 files)
Phase 2: Agent Implementation (Days 2-4)
- Marketing agents (2)
- C-level agents (2)
- Product agent (1)
- Agent template & creation guide
Phase 4-5: Documentation & Testing (Days 5-6)
- Documentation updates (README, INSTALL, USAGE, CLAUDE)
- Comprehensive testing & validation
Out of Scope (Future Phases)
- Installation script (install.sh) → Phase 3
- Uninstall script (uninstall.sh) → Phase 3
- Remaining 37 agents (project management, engineering, RA/QM) → Future sprints
- Plugin marketplace submission → Phase 6-7
- Backwards compatibility migration → Phase 3
Key Stakeholders
Primary:
- Repository users (developers, product teams, marketers, executives)
- Future Anthropic marketplace users
Secondary:
- Contributors to claude-code-skills
- Teams using skills in production
Dependencies
External Dependencies
GitHub Automation ✅ (Complete)
- Smart-sync workflow configured
- PROJECTS_TOKEN secret added
- Project #9 board configured
- Labels created
Existing Skills ✅ (Complete)
- 42 production skills
- 97 Python automation tools
- Complete knowledge bases
Internal Dependencies
Implementation Plan ✅ (Complete)
documentation/implementation/implementation-plan-november-2025.md- 50+ pages with detailed specifications
GitHub Issues ✅ (Complete)
- 8 issues created (#8-#16, excluding #10)
- All linked to Milestone: Skill-Agent Integration v1.0
- All on Project #9 board
Factory Reference ✅ (Available)
- claude-code-skills-factory project
- Standards files to port
- Agent patterns to reference
Risks & Mitigation
Risk 1: Relative Path Resolution Failures
Probability: Medium Impact: High Mitigation:
- Test paths early and often
- Create validation script for path testing
- Document path patterns in creation guide Fallback: Use absolute paths with environment variables
Risk 2: Python Tool Execution Issues
Probability: Low Impact: Medium Mitigation:
- Test each tool from agent context
- Verify working directory assumptions
- Document execution requirements Fallback: Provide wrapper scripts
Risk 3: Scope Creep (Trying to do all 42 agents)
Probability: High Impact: High Mitigation:
- Strict focus on 5 foundational agents
- Template system enables future expansion
- Document "out of scope" clearly Fallback: Defer additional agents to future sprints
Risk 4: Documentation Burden
Probability: Medium Impact: Medium Mitigation:
- Use agent template to standardize
- Reference existing skill documentation
- Keep agent docs focused on workflows Fallback: Minimal viable documentation for v1.0
Success Metrics
Quantitative Metrics
- Directory Structure: 10 directories created
- Standards Files: 5 files ported and adapted
- Agents Created: 5 agents fully implemented
- Documentation Files: 4 files updated/created
- Test Coverage: 100% of agents tested
- Path Resolution: 100% success rate
- Python Tool Execution: 100% success rate
Qualitative Metrics
- User Experience: Clear, guided workflows in each agent
- Code Quality: All quality gates pass
- Documentation Quality: Beginner-friendly, actionable
- Maintainability: Template enables easy agent creation
- Architecture: Clean separation of skills vs agents
Sprint Team
Lead: Implementation Team Contributors:
- Documentation Team
- Quality Assurance Team
Reviewers:
- Repository Maintainer
- Domain Experts (marketing, C-level, product)
Related Documents
- Implementation Plan:
documentation/implementation/implementation-plan-november-2025.md - GitHub Milestone: Skill-Agent Integration v1.0
- Project Board: Project #9: @claude-code-skills
- GitHub Issues: #8, #9, #11, #12, #13, #14, #15, #16
- Factory Reference:
/Users/rezarezvani/projects/claude-code-skills-factory
Sprint Schedule Overview
Week 1 (Nov 5-8):
- Days 1: Foundation (directories, standards)
- Days 2-4: Agents (marketing, C-level, product)
Week 2 (Nov 11-15):
- Days 5-6: Documentation & testing
- Buffer: 3 days for unexpected issues
Target Completion: November 15, 2025 (4 days buffer before Nov 19 deadline)
Next Steps
- ✅ Review sprint plan (context.md + plan.md)
- ✅ Confirm sprint goals and scope
- ✅ Begin implementation in optimal order
- Track progress daily on Project #9 board
- Update living docs (README, CLAUDE) as we complete phases
Document Version: 1.0 Created: November 5, 2025 Last Updated: November 5, 2025 Status: Active Sprint