Pure structural move of the iris team's existing skill to the
agentskills.io spec layout. The body content, section structure,
tables, and rule prose stay byte-for-byte identical — only the file
locations change and the SKILL.md gets minimal markup tweaks to stay
discoverable under the new layout.
Moves (git mv, history preserved):
rules/setup-cloud-service.md → references/setup-cloud-service.md
rules/setup-auth-token.md → references/setup-auth-token.md
rules/session-when-to-use.md → references/session-when-to-use.md
rules/session-add-event.md → references/session-add-event.md
rules/session-retrieval.md → references/session-retrieval.md
rules/ltm-bulk-create.md → references/ltm-bulk-create.md
rules/ltm-search.md → references/ltm-search.md
rules/ltm-organize.md → references/ltm-organize.md
rules/promotion-overview.md → references/promotion-overview.md
For each moved file: only the build-pipeline YAML frontmatter at the
top is stripped (`title`, `impact`, `tags`, etc. — fields the rules
compiler used). The actual rule content, including its H2 heading,
code blocks, and tables, is unchanged.
SKILL.md edits are minimal:
- Quick Reference list items get explicit links to references/<file>.md
so skill-validator recognizes the references as discoverable. The
rule names, descriptions, ordering, and section headings are kept
exactly as the iris team wrote them.
- "How to Use" sample paths changed from rules/*.md to references/*.md.
- The "Full Compiled Document" section is removed (AGENTS.md is gone).
Deletes the legacy files that no longer apply to a spec-format skill:
AGENTS.md, README.md, metadata.json, and the three rules/ template
files (_contributing.md, _sections.md, _template.md).
Drops the iris-development entry from
packages/redis-development-build/src/config.ts since iris no longer
goes through the rules compiler. The compiler itself stays in place
for now — redis-development is still rules-based and will be retired
in #29.
Validation:
- skill-validator check skills/iris-development --allow-dirs=evals → passed
- npm run validate → rules, claude-plugins, cursor-plugins all green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-observability/ covering the two observe-* rules
from skills/redis-development/rules/ in agentskills.io spec layout:
observe-metrics → references/metrics.md
observe-commands → references/commands.md
SKILL.md summarizes the key metrics to monitor (with alert thresholds),
the built-in commands for incident triage (SLOWLOG, INFO, MEMORY DOCTOR,
CLIENT LIST, FT.PROFILE), and a short pointer to Redis Insight as the
interactive GUI complement.
Additive only: the source observe-*.md rules under skills/redis-development/
remain in place so the legacy compiled AGENTS.md continues to serve
existing plugin consumers unchanged. They are removed in the final
cleanup PR alongside the rest of the rules/ tree.
Validation:
- skill-validator check skills/redis-observability → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-security/ covering the three security-* rules
from skills/redis-development/rules/ in agentskills.io spec layout:
security-auth → references/auth.md
security-acls → references/acls.md
security-network → references/network.md
SKILL.md frames the skill around three layers that all need to be in
place for a production-grade deployment: authentication + TLS, ACL-
based least-privilege users, and network exposure controls (bind +
firewall + rename-command). References carry the full Python and
Java code samples and configuration snippets.
Additive only: the source security-*.md rules under skills/redis-development/
remain in place so the legacy compiled AGENTS.md continues to serve
existing plugin consumers unchanged. They are removed in the final
cleanup PR alongside the rest of the rules/ tree.
Validation:
- skill-validator check skills/redis-security → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-clustering/ covering the two cluster-* rules
from skills/redis-development/rules/ in agentskills.io spec layout:
cluster-hash-tags → references/hash-tags.md
cluster-read-replicas → references/read-replicas.md
SKILL.md frames the skill around the two failure modes that bite most
new cluster users: CROSSSLOT errors on multi-key operations (solved by
hash tags) and overloading primaries with read traffic (solved by
replica reads). Reference files carry the full Python and Java code
samples.
Additive only: the source cluster-*.md rules under skills/redis-development/
remain in place so the legacy compiled AGENTS.md continues to serve
existing plugin consumers unchanged. They are removed in the final
cleanup PR alongside the rest of the rules/ tree.
Validation:
- skill-validator check skills/redis-clustering → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-semantic-cache/ covering the two semantic-cache-*
rules from skills/redis-development/rules/ in agentskills.io spec layout:
semantic-cache-langcache-usage → references/langcache-usage.md
semantic-cache-best-practices → references/best-practices.md
SKILL.md describes the cache-aside flow, similarity-threshold tuning
table, and per-task cache separation; reference files carry the SDK +
REST samples and best-practices detail. Preserves the upstream
"LangCache is in preview" callout.
Additive only: the source semantic-cache-*.md rules under
skills/redis-development/ remain in place so the legacy compiled
AGENTS.md continues to serve existing plugin consumers unchanged.
They are removed in the final cleanup PR alongside the rest of the
rules/ tree.
Validation:
- skill-validator check skills/redis-semantic-cache → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-vector-search/ covering the four vector-* rules
from skills/redis-development/rules/ in agentskills.io spec layout:
vector-algorithm-choice → references/algorithm-choice.md (HNSW vs FLAT)
vector-index-creation → references/index-creation.md (DIM, metric, etc.)
vector-hybrid-search → references/hybrid-search.md (filtered vector)
vector-rag-pattern → references/rag-pattern.md (full RAG pipeline)
SKILL.md summarizes index configuration, algorithm choice, hybrid
filtering, and the RAG pattern; the four reference files carry the
full code samples. The skill positions itself as a layer on top of
redis-query-engine, since vector fields live inside RQE indexes.
Additive only: the source vector-*.md rules under skills/redis-development/
remain in place so the legacy compiled AGENTS.md continues to serve
existing plugin consumers unchanged. They are removed in the final
cleanup PR alongside the rest of the rules/ tree.
Validation:
- skill-validator check skills/redis-vector-search → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-query-engine/ covering the six rqe-* rules from
skills/redis-development/rules/ in agentskills.io spec layout:
rqe-dialect → references/dialect.md
rqe-field-types → references/field-types.md
rqe-index-creation → references/index-creation.md
rqe-index-management → references/index-management.md
rqe-query-optimization → references/query-optimization.md
rqe-skip-initial-scan → references/skip-initial-scan.md
SKILL.md carries decision-oriented summaries (field-type table,
DIALECT 2 default, schema/prefix rule, alias-based zero-downtime
updates, SKIPINITIALSCAN guidance, query-optimization levers) with
pointers into references/ for full code samples.
Additive only: the source rqe-*.md rules under skills/redis-development/
remain in place so the legacy compiled AGENTS.md continues to serve
existing plugin consumers unchanged. They are removed in the final
cleanup PR alongside the rest of the rules/ tree.
Validation:
- skill-validator check skills/redis-query-engine → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Introduces skills/redis-connections/ covering the five conn-* rules from
skills/redis-development/rules/ in agentskills.io spec layout:
conn-pooling → references/pooling.md (pool vs multiplex)
conn-pipelining → references/pipelining.md (batch round-trips)
conn-blocking → references/blocking.md (KEYS/SMEMBERS/SCAN)
conn-client-cache → references/client-cache.md (RESP3 caching)
conn-timeouts → references/timeouts.md (socket timeouts)
SKILL.md carries inline summary tables and key principles; full
Python/Java examples live in references/, loaded on demand.
Additive only: the source conn-*.md rules under skills/redis-development/
remain in place so the legacy compiled AGENTS.md continues to serve
existing plugin consumers unchanged. They are removed in the final
cleanup PR alongside the rest of the rules/ tree.
Validation:
- skill-validator check skills/redis-connections → passed (0 warnings)
- npm run validate → rules + plugin validators green
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore(validate): allow evals/ directory in spec-format skills
* feat(redis-core): add spec-compliant skill for data modeling
* feat(redis-core): move eval suite from redis-development
* chore(eval): show generation cost only in skill-vs-baseline comparison
* docs: note agentskills.io migration in root AGENTS.md
The Python and TypeScript SDKs were regenerated against an updated OpenAPI
spec that types `createdAt` as `datetime.datetime` / `Date` (UTC) instead
of Unix milliseconds, and added a server-set `system_timestamp` /
`systemTimestamp` field on every SessionEvent.
Updates session, ltm, and setup rules to match, including the
LongTermMemory `createdAt` filter and the seconds-vs-milliseconds
anti-pattern (replaced with naive-datetime gotcha).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Address two issues flagged in PR review:
1. Validate pluginRoot and source with isSafeRelativePath before using
them in path.resolve. Without this, absolute paths or .. traversals
in marketplace.json would pass validation silently.
2. Error when the per-plugin .cursor-plugin/plugin.json is missing
instead of silently skipping it. A missing manifest would prevent
the plugin from loading, so the validator should catch it.
Made-with: Cursor
displayName is not part of the Cursor plugin manifest schema.
Only name, description, version, author, homepage, repository,
license, keywords, and logo are recognized fields.
Reference: https://cursor.com/docs/reference/plugins
Made-with: Cursor
The pre-commit validator previously required a root plugin.json and
would fail when only marketplace.json was present.
Refactor the validator to check for marketplace.json first, falling
back to root plugin.json for single-plugin repos. For marketplace
repos, validate the marketplace manifest (name, owner, plugins array),
resolve each plugin directory using pluginRoot + source, and validate
per-plugin manifests with paths relative to the plugin directory.
Made-with: Cursor
Add description and alwaysApply: true to all 34 rule files for Cursor
plugin compatibility. description gives the IDE a summary to display
in the rules list and helps the agent understand when to apply each
rule. alwaysApply: true ensures rules are always active rather than
only available on request.
Update the rule template, README example, and AGENTS.md to reflect
the new frontmatter fields for contributors.
Reference: https://cursor.com/docs/reference/plugins
Made-with: Cursor
Cursor resolves plugin directories using pluginRoot + source from
marketplace.json. Update marketplace.json to set pluginRoot: "skills"
and source: "redis-development" so the plugin resolves to
skills/redis-development/.
Move the per-plugin manifest from plugins/redis-development/ to
skills/redis-development/ (the resolved plugin directory), fix the
author field to use email instead of url, remove stale skills/rules
path overrides so Cursor uses auto-discovery, and add the logo field.
Move the logo into skills/redis-development/assets/ because Cursor
resolves relative logo paths from the plugin directory and forbids
.. in paths.
Remove the redundant root .cursor-plugin/plugin.json which is not
needed when marketplace.json is present.
Made-with: Cursor
Add displayName and version to the nested Cursor plugin manifest so it conforms to the expected manifest schema when loaded from marketplace source paths.
Made-with: Cursor
Add Cursor-native manifest files for the nested redis-development plugin and root marketplace so Cursor can discover skills when resolving plugin sources under plugins/.
Made-with: Cursor
Wire official redis/mcp-redis into Claude and Cursor plugin manifests and document optional MCP environment setup in README.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Accept language labels (Python, Java, etc.) as valid code example labels
- Make 'Incorrect' examples optional - rules can use 'When to use' guidance instead
- This aligns with the updated rule structure that distinguishes between anti-patterns and feature introductions
- Add 5 new rule files: conn-client-cache, data-hash-field-expiry, data-incr, data-transactions, rqe-skip-initial-scan
- Add Java (Jedis) examples to 11 existing rules
- Update json-vs-hash.md: add String as third option, fix GEO indexing info
- Improve rule patterns: use 'When to use/When NOT needed' for feature introductions instead of 'Incorrect' for optional features
- Update SKILL.md to reflect new rule structure for skills.sh
- Update root AGENTS.md with guidance on when to use Incorrect examples
- Update _template.md with Pattern A (Incorrect) vs Pattern B (When to use) guidance
Valentin Kirilov