feat: add skills#241
Open
Puppo wants to merge 1 commit into
Open
Conversation
Ports the nearform-sql skill from the nearform/skills marketplace (plugins/nearform-sql/) into this repo at skills/nearform-sql/, so that `npx skills add nearform/sql` installs it directly. The skills/ root is one of the two layouts universally discovered by the vercel-labs/skills CLI (the other being a SKILL.md at the repo root), so the skill is harness-neutral and works under Claude Code, Cursor, Codex, Kiro, Windsurf, and ~50 other agents without per-vendor mirroring. Files: - SKILL.md: when-to-use, install/import, golden rule, statement-object getters table, composing queries, best-practices checklist. - references/api-cheatsheet.md: getters, glue, map, quoteIdent, unsafe, deprecated append, undefined-throws gotcha. - references/patterns.md: Fastify integration, dynamic WHERE/UPDATE, bulk INSERT, IN-lists, identifier migration recipes, anti-patterns table.
|
No linked issues found. Please add the corresponding issues in the pull request description. |
Puppo
marked this pull request as ready for review
July 23, 2026 15:47
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
1 participant
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 introduces comprehensive documentation for the
nearform-sqlskill, providing guidance and best practices for using the@nearform/sqllibrary to write secure, parameterized SQL queries in Node.js. The documentation covers installation, API usage, integration patterns (including with Fastify), and security considerations. These additions are intended to help engineers adopt safe SQL practices and leverage the library's advanced features.Skill documentation and guides:
SKILL.mdto document thenearform-sqlskill, including an overview, installation instructions, core usage patterns, helper functions, and a best practices checklist for preventing SQL injection and writing robust queries.references/api-cheatsheet.mdwith a concise API reference for@nearform/sql, detailing the statement object, helper methods (glue,map,quoteIdent,unsafe), and important caveats such as the handling ofundefinedvalues.references/patterns.mdwith practical recipes and integration examples, including Fastify setup, dynamic query construction (conditionalWHERE, dynamicSET, bulkINSERT,INlists), safe handling of identifiers, and anti-patterns to avoid in code review.