CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning-with-files-ar

تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل المحلية التابعة للمشروع نفسه، بينما قد يصدر --replay مقتطفات محدودة مؤطرة بقيمة nonce. يمكن للوضع المحكوم الاختياري طلب المتابعة فقط عندما يدعمه المضيف، ولا ينفذ أبدًا أوامر معلنة في Markdown. لا تتضمن المهارة مسارًا لرفع البيانات عبر الشبكة. تُستخدم للبحث أو العمل الذي يحتاج إلى 5 استدعاءات أدوات أو أكثر.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/i18n/planning-with-files-ar/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 body delivers a highly actionable, well-sequenced planning workflow with real validation checkpoints and error-recovery loops, and every referenced script exists in the bundle. Its weaknesses are repetition of storage-location and security statements, and references to template files and plan-inventory.md that are absent from the bundle, which weakens both conciseness and navigation.

Suggestions

State the planning-file storage location and the security boundaries once each (in their dedicated sections) and remove the duplicates from the quick-start and session-catchup sections.

Ship templates/task_plan.md, templates/findings.md, templates/progress.md, and plan-inventory.md in the bundle, or remove those links and inline the minimal template structure so the quick start works as distributed.

Move the detailed set-active-plan listing/archive workflow into a reference file (e.g. plan-inventory.md once it exists) and keep a one-line pointer in SKILL.md to reduce body length.

DimensionReasoningScore

Conciseness

The body is mostly efficient — tables, terse rules, and concrete commands rather than concept explanations — but the storage-location guidance ("ملفات التخطيط الخاصة بك توضع في دليل المهمة المحدد داخل مشروعك") and the security-boundary statements (no session-store reads, no network upload, nonce framing) are each repeated three times across the quick start, the session-catchup section, and the الحدود الأمنية section. This matches anchor 3 (mostly efficient but includes some unnecessary repetition that could be tightened) rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Commands are copy-paste ready in both bash and PowerShell variants (e.g. `sh "$PWF_SKILL_DIR/scripts/check-complete.sh" --validate path/to/task_plan.md`, init-session.sh, set-active-plan.sh --list --json), with concrete status strings and an error-logging table. It falls short of anchor 5 because the quick-start instruction to use the templates points at templates/task_plan.md, templates/findings.md, and templates/progress.md, none of which exist in the bundle, leaving a minor gap in executable guidance.

4 / 5

Workflow Clarity

The workflow is clearly sequenced with explicit validation and feedback loops: state restoration is a numbered procedure with fallback rules, plan creation requires check-complete.sh validation "قبل التنفيذ وبعد تعديل بنية المراحل" (before execution and after structural changes), and the three-attempt failure protocol ends in asking the user. Checklists (five-question restart test, read/write decision matrix) and user-confirmation gates for archiving (--archive preview, --yes to execute) match anchor 5.

5 / 5

Progressive Disclosure

Sections are well-organized and references are clearly signaled (templates links, plan-inventory.md, a scripts list), but scored against the actual bundle the templates/ directory and plan-inventory.md do not exist, so those navigation targets are dead. Additionally, the detailed set-active-plan/archive workflow is inline content that could live in a separate reference file, matching anchor 3 (structure present, references present but not fully sound, content that should be separate is inline) rather than anchor 4.

3 / 5

Total

15

/

20

Passed

Description

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

A strong description that explicitly answers both what the skill does and when to use it, with concrete file names, commands, and a quantified trigger threshold. Its main weaknesses are that security fine-print crowds out capability coverage and a few natural trigger synonyms are missing.

DimensionReasoningScore

Specificity

The description lists several concrete actions with named artifacts: "يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص", lifecycle hooks injecting planning context, auto-restore reading project planning files only, and explicit session-catchup.py --metadata/--replay behaviors. It stops short of anchor 5 because a large share of the text is devoted to security-boundary disclaimers while core planning capabilities (plan creation, progress tracking, failure handling) receive only implicit coverage.

4 / 5

Completeness

The 'what' is clearly and explicitly stated (file-based persistent planning keeping three named files with hook-driven context injection), and the 'when' is explicit with a concrete trigger: "تُستخدم للبحث أو العمل الذي يحتاج إلى 5 استدعاءات أدوات أو أكثر". This matches anchor 5, which requires both what and when with concrete trigger phrases; anchor 4 would require the when-clause to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural trigger terms are present: "تخطيط" (planning), "بحث" (research), "متعدد الخطوات" (multi-step), and the concrete threshold "5 استدعاءات أدوات أو أكثر" (5+ tool invocations). This matches anchor 4's level of good-but-not-exhaustive coverage; it misses common variations users might say such as todo lists, task tracking, resuming, or context management.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (persistent file-based planning with specific filenames, scripts, and governed-mode behavior) that is mostly distinct from other skills. It is not anchor 5 because the trigger 'work needing 5+ tool invocations' is broad enough to overlap with any complex-task or todo/planning skill.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

OthmanAdi/planning-with-files

Path

skills/i18n/planning-with-files-ar/SKILL.md

Reviewed

Table of Contents

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.