[FEATURE]: File-specific skill auto-loading and protected context buffer for skills and AGENTS.md

Checklist

I have searched the existing issues and confirmed this is not a duplicate

Problem

When using OpenCode in long sessions, two issues make Agent Skills (SKILL.md) and AGENTS.md unreliable:

1. Skills are not automatically applied to specific files

A skill like session-log defines how ROADMAP.md, SESSIONS.md, CHANGELOG.md, and SUMMARY.md should be formatted. But the agent has no mechanism to detect that a target file has an associated skill, load it automatically, and apply its rules. The skill exists but is often ignored because the agent forgets to load it before editing the file.

2. Skills and AGENTS.md are evicted during context compaction

When the context fills up and triggers compaction, loaded skill content and AGENTS.md rules are lost from the active context. The agent continues working as if no rules exist — ignoring formatting, conventions, and workflow instructions.

Suggested solution

A. File-to-Skill mapping

Associate files with skills so the agent loads the skill automatically before editing:

{
  "skills": {
    "file_map": {
      "ROADMAP.md": "session-log",
      "SESSIONS.md": "session-log",
      "CHANGELOG.md": "session-log",
      "*.rs": "rust-api-first",
      "docs/**/*.md": "docs-only"
    }
  }
}

B. Protected context buffer for skills and AGENTS.md

Introduce a protected memory region that compaction cannot evict:

{
  "compaction": {
    "protected": {
      "AGENTS.md": true,
      "skills": true
    }
  }
}

This ensures the agent always has access to project rules regardless of session length.

This issue doesn't fully meet our contributing guidelines.

What needs to be fixed:

This appears to be a feature request, but the title does not start with [FEATURE]: as required by the feature request template.
The feature request template requires a verification checkbox confirming you searched existing issues. Please use the proper template so all required fields are present.

Please edit this issue to address the above within 2 hours, or it will be automatically closed.

This issue might be a duplicate of existing issues. Please check:

[FEATURE]: Post-compaction reload for skills, AGENTS.md and instruction files #37627: Nearly identical request — skills and AGENTS.md lost after compaction, with a suggested auto-reload/re-inject mechanism (overlaps heavily with Problem 2 and Solution B here)
FEATURE]: Option to automatically reinject original prompt post-compaction #37551: Feature request for automatically reinjecting the original prompt post-compaction (overlaps with the protected context buffer concept)
[FEATURE]: Support path-scoped rules similar to Cursor globs #37463: Feature request for path-scoped rules similar to Cursor globs (overlaps with the file-to-skill mapping concept in Solution A)

If you believe this was flagged incorrectly, please let a maintainer know.

Thanks for updating the issue! It now follows our contributing guidelines and looks great. We appreciate you taking the time to clarify the problem and proposed solution.

Thanks for updating the issue! It now follows our contributing guidelines. We appreciate you taking the time to address the feedback.

To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Navigation Menu

Repository navigation

[FEATURE]: File-specific skill auto-loading and protected context buffer for skills and AGENTS.md #37629

Checklist

Problem

1. Skills are not automatically applied to specific files

2. Skills and AGENTS.md are evicted during context compaction

Suggested solution

A. File-to-Skill mapping

B. Protected context buffer for skills and AGENTS.md

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[FEATURE]: File-specific skill auto-loading and protected context buffer for skills and AGENTS.md #37629

Description

Checklist

Problem

1. Skills are not automatically applied to specific files

2. Skills and AGENTS.md are evicted during context compaction

Suggested solution

A. File-to-Skill mapping

B. Protected context buffer for skills and AGENTS.md

Activity

github-actions commented on Jul 18, 2026

github-actions commented on Jul 18, 2026

github-actions commented on Jul 18, 2026

github-actions commented on Sep 18, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions