skills-assist

Agent Skill authoring requires writing correct SKILL.md frontmatter, body instructions, and companion-file patterns. You can get authoritative guidance on structuring these elements to ensure your skill loads and invokes correctly across harnesses.

Skill design involves choosing between context fork, user-invocable, and allowed-tools configurations. These enhanced format features dictate how the skill interacts with the agent runtime, affecting portability and invocation behavior across different harnesses.

Troubleshooting Agent Skills loading or invocation issues involves diagnosing SKILL.md structure, frontmatter syntax, and compatibility configurations. You can reference spec lookup and compatibility check materials to resolve these runtime failures.

Choosing between skills and agents depends on your architecture decisions and task complexity. Skills provide portable, cross-harness instructions, while agents offer broader autonomous capabilities for complex workflows requiring independent decision-making.

Cross-harness portability for Agent Skills depends on adhering to the Agent Skills specification and avoiding harness-specific enhancements. You can verify your skill's compatibility by checking spec compliance and enhanced format feature usage.

SKILL.md loading failures in Claude Code often stem from incorrect frontmatter syntax or unsupported enhanced format features. Diagnose the issue by checking specification compatibility and validating your companion-file patterns.