refactor(sldd): unify skill entrypoint#9
Open
dearrudam wants to merge 7 commits into
Open
Conversation
omatheusmesmo
requested changes
May 25, 2026
Collaborator
omatheusmesmo
left a comment
There was a problem hiding this comment.
What happen with the frontmatter?
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices#skill-structure
…fy rerun behavior
…d project context intake
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request significantly updates the documentation to clarify and enforce the repository's single-skill architecture, expand content and contribution guidelines, and provide more precise installation and usage instructions. The changes ensure that users and contributors understand the current structure, allowed content, and workflow of the SLDD skill, while removing legacy references and tightening repository policies.
Key changes include:
Repository structure and content policy
AGENTS.mdto clarify that only one executable SLDD skill entrypoint (skills/sldd/SKILL.md) is permitted, with steps, templates, and schema files organized under dedicated subdirectories. Expanded the "Do" and "Don't" sections to enforce the single-skill model, progressive disclosure, and preservation of legacy resume compatibility. Added a new "Repository Content Policy" section specifying allowed file types and restricting runtime code and CI/CD changes.Installation and development instructions
README.mdinstallation instructions to reflect the single-skill structure (removing references to multiple skills likesldd-*), and updated the development installation script section to clarify symlink/copy options and their effects.Documentation and workflow clarity
README.mdto describe the single-skill layout, progressive disclosure, and the canonical journal storage under.sldd/specs/. Clarified the use of_spec-journal.jsonand legacy compatibility.Terminology and consistency
These changes help ensure that the repository remains focused, maintainable, and aligned with the intended SLDD methodology.