Name: peoplegoal
Rating: 52.8 (1 reviews)
Author: membranedev

peoplegoal

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

Quality

59%

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/peoplegoal/SKILL.md

Quality

Content

61%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 skill delivers practical, executable Membrane CLI guidance with a solid connection-state workflow, but it would benefit from trimming product filler and adding validation before destructive proxy or action operations.

Suggestions

Add a validation checkpoint before destructive operations, e.g. require inspecting the action outputSchema or confirming non-GET proxy methods before running them.

Trim the introductory product description and remove the filler line "Use action names and parameters as needed" to improve token efficiency.

Fix the dangling "Step 2" reference ("Skip to Step 2") by labeling the Searching/Running sections as explicit numbered steps.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with code blocks and a flag table, but the product intro ("It's used by HR departments and managers to track performance...") and filler like "Use action names and parameters as needed" could be trimmed.	3 / 5
Actionability	Concrete, copy-paste-ready commands cover the common cases (install, login, connection ensure, action list/run, proxy) with a real peoplegoal.com URL, though placeholders like CONNECTION_ID, actionId, and QUERY leave minor gaps and there is no fully worked end-to-end example.	4 / 5
Workflow Clarity	The connection setup has a clear sequence with a polling feedback loop over READY/BUILDING/CLIENT_ACTION_REQUIRED states, but destructive proxy methods (DELETE/PUT/PATCH) and action runs lack validation checkpoints, capping this dimension at 3 per the rubric.	3 / 5
Progressive Disclosure	The body is a single self-contained file with clear section headers and logical navigation, no nested references, and content stays one level deep; minor gaps are the thin "Popular actions" section and inline flags table that a 170-line skill could optionally split.	4 / 5
	Total	14 / 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 cleanly states what and when in third person and is anchored to a specific product, but it relies on generic action verbs and lacks the natural HR-specific trigger terms that would make it sharply distinctive.

Suggestions

Replace generic verbs with concrete PeopleGoal capabilities, e.g. "Manage objectives, reviews, check-ins, and recognition records; automate PeopleGoal workflows."

Add natural trigger phrases users actually say, e.g. "Use when the user wants to manage performance goals, run reviews, or track check-ins in PeopleGoal."

Trim the buzzwordy "automate workflows" unless paired with a concrete example, to reduce overlap with generic integration skills.

Dimension	Reasoning	Score
Specificity	The phrase "Manage data, records, and automate workflows" names the domain but uses generic verbs ("manage", "automate") rather than concrete PeopleGoal capabilities like objectives, reviews, or check-ins.	2 / 5
Completeness	Both "what" ("Manage data, records, and automate workflows") and an explicit "when" ("Use when the user wants to interact with PeopleGoal data") are present, though the trigger is generic rather than concrete.	4 / 5
Trigger Term Quality	"PeopleGoal" and "interact with PeopleGoal data" supply the key product keyword, but natural HR phrases users would say (objectives, performance reviews, check-ins) are absent, so common synonyms are missing.	3 / 5
Distinctiveness Conflict Risk	Naming the specific product PeopleGoal creates a clear niche with mostly distinct triggers, though the generic "manage data/records/workflows" language leaves minor overlap risk with other app-integration 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/peoplegoal/SKILL.md
Commit: f484c82

Reviewed: 5 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.