Name: soci
Rating: 57.599999999999994 (1 reviews)
Author: membranedev

Blog Docs Log in Get started

soci

Soci integration. Manage data, records, and automate workflows. Use when the user wants to interact with Soci data.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/soci/SKILL.md

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with executable CLI commands and a strong connection-setup workflow, but it lacks validation/feedback checkpoints around the destructive action-run and proxy-request operations.

Suggestions

Add validation/verification guidance for action runs and proxy mutations (e.g. confirm a GET before mutating, check the output error field, retry on transient failure).

Move the inlined inputSchema/outputSchema and clientAction schema detail into a short reference section or reference file to tighten the overview.

Tighten the introductory platform description and auth-plumbing commentary to reduce over-explanation.

Dimension	Reasoning	Score
Conciseness	The body is efficient with direct CLI commands and a lean options table, though the opening platform summary and phrases like "so you can focus on the integration logic rather than auth plumbing" could be trimmed.	4 / 5
Actionability	It provides copy-paste-ready, fully executable bash commands for install, login, connection ensure/get, action list/run, and proxy requests, with a complete flags table covering common cases.	5 / 5
Workflow Clarity	The connection workflow has good state-polling checkpoints, but running actions and proxy HTTP requests can be destructive/batch operations and lack validation or feedback loops, capping workflow clarity at 3 per the rubric.	3 / 5
Progressive Disclosure	No bundle files exist; the single self-contained file is well-sectioned with clear headers, with only minor organization gaps around inlined action-schema detail.	4 / 5
	Total	16 / 20 Passed

Description

57%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description correctly includes a Use-when clause and names the Soci platform, but its capability list is generic and it omits the natural trigger terms (scheduling, analytics, social media) that would distinguish it.

Suggestions

Replace the generic "Manage data, records, and automate workflows" with concrete Soci actions such as scheduling posts, managing content, and tracking analytics.

Add natural user trigger phrases (e.g. "Use when the user wants to schedule Soci posts, manage content, or check social analytics").

Dimension	Reasoning	Score
Specificity	It names the Soci domain but the actions ("Manage data, records, and automate workflows") are generic and minimal rather than concrete Soci-specific capabilities like scheduling posts or tracking analytics.	2 / 5
Completeness	It states both what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Soci data"), though the trigger could be more specific.	4 / 5
Trigger Term Quality	"interact with Soci data" gives some relevant keywords but misses the natural phrases users would say (posts, scheduling, analytics, social media) and common synonyms.	3 / 5
Distinctiveness Conflict Risk	Naming the specific Soci platform gives a clear niche with minimal conflict risk, though the generic data/records phrasing leaves minor overlap with other data skills.	4 / 5
	Total	13 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: membranedev/application-skills
Path: skills/soci/SKILL.md
Commit: f484c82

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.