Skip to content

update: added skill files#54

Merged
cs-raj merged 5 commits intodevelopmentfrom
update/DX-5369
Apr 13, 2026
Merged

update: added skill files#54
cs-raj merged 5 commits intodevelopmentfrom
update/DX-5369

Conversation

@cs-raj
Copy link
Copy Markdown
Contributor

@cs-raj cs-raj commented Apr 9, 2026

Summary

Adds a repo-wide agent and contributor guide (AGENTS.md), a skills/ tree with YAML-frontmatter SKILL.md files, and a Cursor pointer (.cursor/rules/README.md) so editor-specific config does not duplicate canonical docs.

Documentation is repo-specific (dotnet CLI, xUnit, Coverlet, GitHub Actions, branch rules, NuGet) and includes explicit inventories (interfaces, enums, models, mocks, JSON fixtures) instead of vague shorthand.

The Contentstack Utils API skill includes code flow sections (RTE JsonToHtml, GQL edges, RenderContent, variant metadata) with Mermaid diagrams and pointers into Utils.cs, HtmlDocumentExtension, and Metadata.

Changes

Entry and index

  • AGENTS.md — Project purpose, stack, commands (including quick dotnet test Contentstack.Utils.sln), CI workflow table, skills index, Cursor note.
  • skills/README.md — When to use each skill.

Skills (skills/<name>/SKILL.md)

  • dev-workflow — Branch policy (stagingmaster), build/pack, test scripts, workflows, CODEOWNERS, Talisman, publish secrets wording.
  • testing — Test project packages, test-class map, Resources and mocks (explicit files), quick local test, coverage and CI alignment.
  • code-review — PR checklist and security notes.
  • contentstack-utils — Package and namespaces, models and interfaces, rendering hooks, variants JSON path, Code flows and diagrams, authoritative-source line.
  • csharp-style — Folder and file-level inventory for library layout.

Cursor

  • .cursor/rules/README.md — Points to AGENTS.md only.

Motivation

  • Single source of truth for humans and AI agents: commands, CI, and API boundaries.
  • Discoverability of how rendering works (flows and code pointers) without pasting full sources into markdown.

Notes

  • Documentation-only changes (plus .cursor pointer); no application code changes in this workstream.
  • Exclude this helper file from the PR if you prefer not to commit a PR template artifact; otherwise keep it for future releases.

Copy link
Copy Markdown

@sunil-lakshman sunil-lakshman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cs-raj framework skill details are not added under skills folder.
Here is the reference: Link

harshitha-cstk
harshitha-cstk previously approved these changes Apr 9, 2026
Comment thread skills/code-review/SKILL.md Outdated
Comment thread skills/contentstack-utils/SKILL.md Outdated
Comment thread skills/csharp-style/SKILL.md Outdated
Comment thread skills/dev-workflow/SKILL.md Outdated
Comment thread AGENTS.md Outdated
Comment thread skills/README.md Outdated
sunil-lakshman
sunil-lakshman previously approved these changes Apr 13, 2026
Copy link
Copy Markdown

@sunil-lakshman sunil-lakshman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@cs-raj cs-raj merged commit a24228b into development Apr 13, 2026
11 checks passed
@cs-raj cs-raj deleted the update/DX-5369 branch April 13, 2026 05:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants