social-content

You are an expert social media strategist with direct access to a scheduling platform that publishes to all major social networks. Your goal is to help create engaging content that builds audience, drives engagement, and supports business goals.

Quality

28%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/social-content/SKILL.md

Quality

Content

21%Scale 1-5

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

This skill reads like a comprehensive social media marketing guide or blog post rather than an actionable skill for Claude. It is severely bloated with generic social media knowledge that Claude already possesses, contains no integration with the scheduling platform mentioned in the description, and lacks any executable code or tool-specific commands. The content would benefit enormously from being reduced to ~50-80 lines of truly unique, actionable instructions with detailed reference material split into separate bundle files.

Suggestions

Reduce the body to a concise overview (~50-80 lines) covering only what Claude doesn't already know, and move platform-specific guides, templates, and the reverse engineering framework into separate bundle files (e.g., PLATFORMS.md, TEMPLATES.md, REVERSE_ENGINEERING.md).

Add concrete, executable instructions for the scheduling platform mentioned in the description—include actual API calls, tool commands, or MCP tool usage for creating, scheduling, and publishing posts.

Define a clear end-to-end workflow with validation steps: gather context → create content → review/validate → schedule → verify publication → track performance, with explicit checkpoints at each stage.

Remove generic social media advice (posting times, what works/doesn't, algorithm tips, engagement strategies) that Claude already knows, and focus on project-specific configurations, tool integrations, and unique organizational preferences.

Dimension	Reasoning	Score
Conciseness	This is extremely verbose at 500+ lines, extensively explaining social media concepts, platform strategies, and engagement tactics that Claude already knows well. The vast majority of content is generic social media advice (posting times, what works/doesn't on each platform, hook formulas, engagement strategies) that adds no unique tooling knowledge or novel instructions. Nearly every section could be dramatically condensed or omitted entirely.	1 / 5
Actionability	The skill provides templates and frameworks (hook formulas, post templates, content calendar structures) which offer some concrete guidance, but there is no executable code, no specific tool commands, no API calls, and no integration with the mentioned 'scheduling platform.' Despite claiming access to a scheduling platform, there are zero instructions on how to actually use it. The templates are useful but are essentially pseudocode-level fill-in-the-blank structures.	3 / 5
Workflow Clarity	While there are some sequential lists (like the repurposing workflow and reverse engineering framework), the overall skill lacks clear operational workflows with validation checkpoints. The 'Before Creating Content' section is a questionnaire rather than a workflow. There's no clear process for actually creating and publishing a post end-to-end, no validation steps, and no error handling for the scheduling platform integration that's mentioned in the description.	2 / 5
Progressive Disclosure	This is a monolithic wall of text at 500+ lines with no bundle files or external references for detailed content. Platform-specific guides, templates, hook formulas, the reverse engineering framework, and analytics guidance should all be in separate referenced files. The 'Related Skills' section references other skills but the core content is entirely inlined with no meaningful content splitting.	1 / 5
	Total	7 / 20 Passed

Description

36%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.

This description uses second person voice ('Your goal') and first-person framing ('You are an expert'), which violates the third-person convention. It is too vague about concrete capabilities, lacks a 'when to use' clause, and relies on buzzwords like 'drives engagement' and 'supports business goals' rather than specific actions.

Suggestions

Add an explicit 'Use when...' clause with trigger terms like 'schedule a post', 'social media calendar', 'draft a tweet', 'Instagram caption'

Replace vague language with concrete actions: 'Drafts social media posts, schedules content across platforms, generates hashtags, creates content calendars'

Rewrite in third person voice (e.g., 'Schedules and publishes social media content across major networks') and include specific platform names (Twitter/X, Instagram, LinkedIn, Facebook)

Dimension	Reasoning	Score
Specificity	Names the domain (social media strategy/scheduling) but actions are generic ('create engaging content', 'builds audience', 'drives engagement'). No concrete actions like 'draft posts', 'schedule tweets', 'generate hashtags', etc.	2 / 5
Completeness	Has a vague 'what' (create engaging content, scheduling) but completely lacks a 'when' clause. There is no explicit guidance on when Claude should select this skill.	2 / 5
Trigger Term Quality	Contains some relevant keywords like 'social media', 'scheduling', 'content', 'engagement', but misses natural user phrases like 'post', 'tweet', 'Instagram', 'LinkedIn', 'schedule a post', 'social calendar', or specific platform names.	3 / 5
Distinctiveness Conflict Risk	The mention of 'scheduling platform' and 'social networks' provides some distinction, but 'create engaging content' and 'builds audience' are broad enough to overlap with general marketing or content creation skills.	3 / 5
	Total	10 / 20 Passed

Validation

81%

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 — 9 / 11 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (814 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	9 / 11 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: skills/social-content/SKILL.md
Commit: 57c135b

Reviewed: 17 hours 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.