my-opencode-config  by flpbalada

AI coding assistant configuration with actionable knowledge agents

Created 4 months ago
251 stars

Top 99.8% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

This repository offers a personal configuration for the OpenCode AI framework, designed to transform accumulated knowledge into actionable skills and specialized agents. It targets developers and product managers seeking to enhance coding sessions and problem-solving by making expertise—spanning programming patterns, product management frameworks, and psychological principles—directly executable by AI. The primary benefit is turning passive knowledge into active, AI-driven assistance.

How It Works

The core of this configuration lies in its structured approach to AI augmentation. It defines custom agents for specific tasks, such as code-reviewer for comprehensive analysis, code-simplifier for refactoring, effort-estimator for project planning, and skill-creator for expanding the AI's capabilities. Complementing these agents is an extensive "skills library," which comprises executable notes derived from personal learning across diverse domains. These skills cover technical areas like TypeScript and React best practices, architectural patterns, and front-end technologies (CSS, Tailwind), as well as softer skills in product management frameworks (Jobs-to-be-Done, Business Model Canvas), UX psychology, behavioral design, and decision-making strategies. The system integrates with external services like Context7 for real-time API documentation, Exa for web search and code examples, and Figma MCP for local design file interaction, enabling agents to access and leverage this rich, actionable knowledge base during operation.

Quick Start & Requirements

This repository provides a configuration for OpenCode rather than a standalone application, so direct installation instructions are not present. Users are expected to have OpenCode set up. The configuration includes opencode.json for main settings (plugins, MCP servers, providers), custom agents within the agents/ directory, custom slash commands in commands/, and helper scripts in scripts/. Key dependencies or prerequisites would likely include a functional OpenCode environment and potentially specific versions of Node.js or Python depending on the OpenCode core and plugin implementations. Links to official OpenCode documentation, the associated skills repository (flpbalada/fb-skills), a skills guide, and an agents guide are referenced, suggesting these are essential resources for setup and usage.

Highlighted Details

  • Specialized Agents: Features a suite of custom agents including code-reviewer, code-simplifier, deep-thinker, effort-estimator, git-commit, requirements-analyzer, skill-creator, and talk.
  • Comprehensive Skills Library: Organizes executable knowledge notes across technical domains (TypeScript, React, CSS, Architecture) and business/psychology areas (Product Frameworks, UX Psychology, Behavioral Design, Decision Making, Agile, Product Management).
  • MCP Server Integrations: Leverages Context7 for real-time library/API documentation, Exa for web search and code examples, and Figma MCP for local design file integration.
  • Extensibility: Supports custom slash commands and helper scripts, alongside plugins like @franlol/opencode-md-table-formatter for Markdown table formatting and @mohak34/opencode-notifier for desktop notifications.

Maintenance & Community

The provided README does not contain information regarding notable contributors, sponsorships, partnerships, community channels (e.g., Discord, Slack), or a public roadmap.

Licensing & Compatibility

The project is licensed under the MIT License. This license is permissive and generally allows for commercial use, modification, distribution, and patent use, provided the original copyright and license notice are included.

Limitations & Caveats

As a personal configuration, this repository's utility is tied to the user's existing OpenCode setup and their specific knowledge domain interests. The README does not detail the core OpenCode framework's requirements, potential setup complexities, or specific performance benchmarks for the custom agents and skills. Users may need to consult the linked OpenCode and skills repository documentation for a complete understanding of dependencies and operational nuances.

Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
24 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.