Skip to content

Add OpenCode agent skills for MAPL development#4393

Merged
tclune merged 2 commits intodevelopfrom
feature/#4392-add-opencode-agent-skills
Feb 12, 2026
Merged

Add OpenCode agent skills for MAPL development#4393
tclune merged 2 commits intodevelopfrom
feature/#4392-add-opencode-agent-skills

Conversation

@tclune
Copy link
Collaborator

@tclune tclune commented Feb 12, 2026

Summary

This PR replaces the monolithic AGENTS.md file with 9 modular OpenCode skills that provide on-demand structured guidance for MAPL development workflows. Each skill is comprehensive, well-documented, and includes examples, important callouts, and cross-references to other skills.

Skills Added

  1. mapl-setup - First-time environment configuration and setup
  2. mapl-build - Building MAPL with NAG, gfortran, Intel compilers
  3. mapl-testing - Running and debugging tests with pFUnit
  4. fortran-style - MAPL Fortran coding standards
  5. mapl-error-handling - Error handling macros and best practices
  6. github-workflow - Git/GitHub conventions and PR process
  7. remote-build - Building on bucy with Intel compiler
  8. pfunit-troubleshooting - Debug pFUnit test failures
  9. compiler-switching - Switch between compilers safely

Key Features

  • Modular design: Skills are loaded on-demand rather than all at once
  • Comprehensive documentation: Each skill includes detailed examples, commands, and troubleshooting
  • Parameterization: Optional ~/.opencode/mapl-config.yaml for user-specific settings with inline examples as fallback
  • Cross-referenced: Skills reference each other for related workflows
  • Standards-based: Follows OpenCode SKILL.md format with YAML frontmatter

Migration from AGENTS.md

The original AGENTS.md content has been migrated and expanded into the appropriate skills. The monolithic file is deleted in this PR.

Benefits

  • Better organization and discoverability
  • Easier maintenance and updates
  • Team-wide access (project-local in .opencode/skills/)
  • Comprehensive guidance for both new and experienced MAPL developers

Fixes #4392

Replace monolithic AGENTS.md with 9 modular OpenCode skills:
- mapl-setup: First-time environment configuration
- mapl-build: Building with NAG, gfortran, Intel compilers
- mapl-testing: Running and debugging tests with pFUnit
- fortran-style: MAPL Fortran coding standards
- mapl-error-handling: Error handling macros and best practices
- github-workflow: Git/GitHub conventions and PR process
- remote-build: Building on bucy with Intel compiler
- pfunit-troubleshooting: Debug pFUnit test failures
- compiler-switching: Switch between compilers safely

Skills provide on-demand structured guidance with comprehensive
examples, CRITICAL/IMPORTANT callouts, and cross-references.
Uses hybrid parameterization with optional ~/.opencode/mapl-config.yaml
and inline examples as fallback.

Fixes #4392
@tclune tclune requested a review from a team as a code owner February 12, 2026 18:30
@tclune tclune added the 0 Diff Trivial The changes in this pull request are trivially zero-diff (documentation, build failure, &c.) label Feb 12, 2026
- Add CHANGELOG.md entry for OpenCode skills addition
- Update github-workflow skill to require CHANGELOG updates for develop PRs
- Add comprehensive CHANGELOG guidelines section with examples
@tclune tclune added the 🎁 New Feature This is a new feature label Feb 12, 2026
@tclune tclune merged commit d96d329 into develop Feb 12, 2026
27 checks passed
@tclune tclune deleted the feature/#4392-add-opencode-agent-skills branch February 12, 2026 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

0 Diff Trivial The changes in this pull request are trivially zero-diff (documentation, build failure, &c.) 🎁 New Feature This is a new feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants