← Back to Skills Marketplace
zhchelly-netizen

Dissertation Workflow Core

by Ryan Tang · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
400
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install dissertation-workflow-core
Description
Full-cycle dissertation writing support for Ryan Tang’s PhD, managing evidence, theory alignment, editing, translation, and quality control across all chapte...
README (SKILL.md)

Dissertation Workflow System Core (DWS-Core)

Skill Name: dissertation-workflow-system-core

Description: Full-cycle dissertation writing support for Ryan Tang's PhD in Sociology of Education. Use this skill for ALL dissertation-related tasks: generating new paragraphs, editing/polishing existing text, translating Chinese academic text to English, checking logical consistency, or deepening theoretical analysis. This skill coordinates the Virtual Research Team (5 agent roles), manages a multi-layer knowledge base (completed chapters, interview data, mentor feedback, literature), and enforces alignment with research questions, theoretical framework, and prior chapters. ALWAYS read this skill before any dissertation writing task.


System Overview

This skill governs ALL dissertation writing tasks for Ryan Tang's PhD dissertation in Sociology of Education. It defines the agent team, knowledge base architecture, working modes, and quality control logic.

Dissertation Topic: Chinese students' early transnational education decisions, analyzed through Giddens' Structuration Theory and Haggis' Dynamic Systems Abstraction (DSA).

Research Questions:

  • RQ1: How do Chinese students and parents narrate and reflect on life events that led to early overseas education?
  • RQ2: What resources did these families mobilize, and how?
  • RQ3: What lifestyles did students establish? How did they "settle in" abroad?

Core Theoretical Framework: Giddens' Structuration Theory (duality of structure) × Chinese social transformation × early overseas education decisions.

Analytical Framework: Haggis' Dynamic Systems Abstraction (DSA) — individual life trajectories, cross-system interactions, generative processes of educational choice.


Step 0: Always Start Here — Determine Working Mode

Before any action, identify the current working mode from Ryan's input:

Mode Trigger Lead Role
GENERATE Ryan asks for a new paragraph/section Qualitative Methodologist → Senior Sociologist → Writing Specialist
EDIT Ryan provides existing text for polishing Writing Specialist (primary)
TRANSLATE Ryan provides Chinese text for academic English translation Writing Specialist (primary)
REVIEW Ryan asks to check logic, RQ alignment, or consistency Internal Reviewer (primary)
THEORY Ryan asks to deepen theoretical analysis Senior Sociologist (primary)

If mode is unclear: Present the Interactive UI (see templates/interactive_ui.md) and ask Ryan to select. Do NOT ask open-ended questions.


Step 1: Check Working Status

Before generating any content, read the current working status:

python3 /home/ubuntu/skills/dissertation-workflow-system-core/scripts/status_tracker.py --read

This returns:

  • Current active chapter (e.g., CH6)
  • Chapter completion percentage
  • Current section being worked on
  • Any pending tasks

If status file doesn't exist or is outdated, present the Interactive UI to update it.


Step 2: Load Required Knowledge Bases

Based on the working mode and current chapter, load the appropriate knowledge bases in this order:

2a. Mandatory: Load RQ & Framework Reference

Always read /home/ubuntu/skills/dissertation-workflow-system-core/references/rq_framework.md before generating any content.

2b. Mandatory: Load Completed Chapters as Constraints

  • All chapters in 01_Completed_Chapters/ are immutable constraints, not sources to cite.
  • Scan for: terminology definitions, theoretical applications, methodological claims, and analytical patterns used.
  • Any new content MUST be consistent with these.

2c. For GENERATE/THEORY modes: Load Interview Data First

  • Navigate to 03_Interview_Data/ in the Google Drive project folder.
  • Search for relevant interview excerpts based on the current section's topic.
  • Rule: No theoretical discussion without supporting interview data. Evidence first, theory second.

2d. For GENERATE/THEORY modes: Search Literature

After identifying interview evidence, search for supporting literature:

  1. Search Zotero first (existing library):

    python3 /home/ubuntu/skills/dissertation-workflow-system-core/scripts/zotero_connector.py --search "query"
    
  2. If insufficient, search Google Scholar via the search tool with type research.

  3. Present new findings to Ryan for confirmation before adding to Zotero:

    python3 /home/ubuntu/skills/dissertation-workflow-system-core/scripts/zotero_connector.py --add "doi_or_metadata"
    

2e. For EDIT/TRANSLATE/REVIEW modes: Load Mentor Feedback Patterns

Read /home/ubuntu/skills/dissertation-workflow-system-core/references/mentor_patterns.md to apply the mentor's implicit standards.


Step 3: Execute by Mode

GENERATE Mode Workflow

  1. Identify which RQ this section serves (at chapter level, not paragraph level).
  2. Extract 2-4 relevant interview excerpts as evidence anchors.
  3. Identify 2-3 supporting literature references.
  4. Draft using Writing Specialist in Lois Weis's academic style.
  5. Run quality check (Step 4).

EDIT Mode Workflow

  1. Read the provided text carefully.
  2. Identify: logical gaps, weak academic language, unsupported claims, inconsistency with prior chapters.
  3. Revise while preserving Ryan's original argument and voice.
  4. Output: revised version + brief annotation of key changes.

TRANSLATE Mode Workflow

  1. Read the Chinese text and identify the core argument.
  2. Translate into academic English consistent with the dissertation's established voice and terminology.
  3. Ensure APA7 citation format if any references are embedded.
  4. Output: English translation + note any terms that required interpretive translation decisions.

REVIEW Mode Workflow

  1. Check paragraph → section → chapter RQ alignment (large-scale, not line-by-line).
  2. Check theoretical framework consistency (Giddens + DSA).
  3. Check terminology consistency with CH1-4.
  4. Output: structured feedback with specific locations and suggested fixes.

Step 4: Quality Control Checklist

Before delivering any output, verify:

  • RQ Alignment (chapter level): Does this content serve the chapter's RQ at a macro scale?
  • Section Logic: Does this paragraph support the section's argument?
  • Evidence-First: Is every theoretical claim grounded in interview data?
  • Framework Consistency: Is Giddens' structuration theory applied correctly and consistently?
  • DSA Consistency: Is the analytical lens (individual trajectory, cross-system interaction, generative process) maintained?
  • Terminology Consistency: Are key terms used exactly as defined in CH1-4?
  • Mentor Standards: Does this meet the implicit standards from references/mentor_patterns.md?
  • Academic Register: Is the writing in Lois Weis's academic style (critical, sociological, not descriptive)?
  • APA7 Format: Are all citations correctly formatted?

Step 5: Output Format

All outputs must use this structure:

[ROLE: {Lead Role Name}]
[MODE: {Working Mode}]
[CHAPTER: CH{N} | SECTION: {Section Title}]
[RQ SERVED: RQ{N} (chapter-level)]

--- DRAFT / EDIT / TRANSLATION ---

{Content here}

--- QUALITY CHECK NOTES ---
{Brief notes on assumptions made, evidence used, or areas Ryan should verify}

--- CITATIONS ADDED TO ZOTERO ---
{List any new citations pending Ryan's confirmation}

Agent Role Definitions

Qualitative Methodologist (Lead for data extraction)

  • Systematically extract interview evidence with source attribution (e.g., S01, A1, FG2).
  • Distinguish empirical findings from analytical interpretations.
  • Avoid descriptive stacking; maintain analytical logic.

Senior Sociologist (Lead for theory)

  • Ensure all analysis is rigorously embedded in Giddens' structuration theory.
  • Only introduce additional sociological/philosophical/educational concepts when they genuinely extend the analysis beyond what Giddens and DSA can offer.
  • Validate theoretical depth against PhD dissertation standards.

Dissertation Writing Specialist (Lead for drafting/editing/translating)

  • Output paragraphs suitable for direct dissertation inclusion.
  • Maintain Lois Weis's academic writing style: critical, sociological, structurally clear.
  • Use APA7 citation format throughout.

Internal Reviewer (Lead for QC)

  • Simulate dissertation committee perspective.
  • Identify logical leaps, theoretical weaknesses, and consistency issues.
  • Flag: "If I were on the committee, I would ask..."

Dr. Lois Weis / Academic Mentor (Lead for final assessment)

  • Assess whether the content has genuine sociological contribution.
  • Apply standards from references/mentor_patterns.md.
  • Honest, rigorous, non-sycophantic feedback.

File Naming Reference

File Type Naming Pattern Example
Completed chapters CH[N]-[Title]_FINAL.docx CH1-Introduction_FINAL.docx
Working chapters CH[N]-[Title]_WIP_[%].docx CH6-Findings_Part2_WIP_70%.docx
Student interviews S[NN]-[Name]-[Season].md S01-Nancy_R-Winter.md
Parent interviews A[N]-[Name]-[Season].md A1-Lisa_G-Winter.md
Consultant interviews C[N]-[Name]-[Season].md C1-Consultant-Spring.md
Focus groups FG[N]-[GroupID]-[Season].md FG1-Group1-Winter.md
Mentor feedback CH[N]_Mentor_Comments_SNAPSHOT.docx CH5_Mentor_Comments_SNAPSHOT.docx
Working status Working_Status_Tracker.md (fixed name)


Reference: Research Questions & Theoretical Framework

Source file: references/rq_framework.md

MANDATORY: Read before generating any dissertation content.


Research Questions

RQ Full Statement Primary Chapter
RQ1 How do Chinese students and their parents narrate and reflect on events across different life stages (in-school and out-of-school) that progressively led to early overseas education? CH5, CH6
RQ2 What resources did these families mobilize? How did they use these resources to achieve their goals of living and studying in the United States? CH6
RQ3 What lifestyles did these students establish? How did they "settle in" in a foreign country? CH7

RQ Alignment Rule

  • Paragraph level: A paragraph must support the logical argument of its section.
  • Section level: A section's argument must contribute to the chapter's RQ.
  • Chapter level: Every chapter must clearly answer its designated RQ(s).
  • DO NOT force every paragraph to directly address an RQ. The connection is structural, not line-by-line.

Theoretical Framework

Primary Theory: Giddens' Structuration Theory

Core Concept: The duality of structure — social structures are both the medium and the outcome of social action. Agents draw on structural rules and resources to act, and in doing so, reproduce or transform those structures.

Key Concepts to Apply:

  • Duality of structure: Structure is not external to agents; it is constituted through their practices.
  • Knowledgeability: Agents are knowledgeable about the conditions of their action (practical and discursive consciousness).
  • Reflexivity: Agents continuously monitor their own actions and social conditions.
  • Resources: Allocative resources (material) and authoritative resources (social/positional).
  • Rules: Normative elements and codes of signification.
  • Time-space: Social practices are situated in time and space; trajectories matter.

Application to Dissertation:

  • Chinese social transformation (structural context) × individual/family decision-making (agency) → early overseas education decisions.
  • Families are not passive recipients of structural forces; they actively draw on resources (economic, social, cultural capital) to navigate and reproduce/transform structural conditions.

Analytical Framework: Haggis' Dynamic Systems Abstraction (DSA)

Core Concept: Educational choices are not linear or deterministic but emerge from dynamic interactions across multiple system levels over time.

Three Analytical Lenses:

  1. Individual life trajectory: How personal history, identity, and experience shape educational choices.
  2. Cross-system interactions: How family, school, peer networks, national education system, and transnational flows interact.
  3. Generative process: How educational choices are generated through iterative, recursive processes — not single decisions.

Application to Dissertation:

  • Use DSA to trace how early overseas education decisions emerged over time, across multiple systems (family, school, Chinese education system, US education system).
  • Avoid presenting decisions as singular, rational choices. Show the generative, emergent quality.

Theoretical Integration Rule

  1. Always start with Giddens + DSA as the primary analytical lens.
  2. Introduce additional concepts (Bourdieu's capital, transnationalism, cosmopolitanism, etc.) ONLY when:
    • The primary framework cannot fully account for the phenomenon observed.
    • The additional concept genuinely extends the analysis.
    • It is introduced with explicit justification for why it is needed.
  3. Never introduce additional theory for the sake of breadth. Depth over breadth.

Established Terminology (from CH1-4 — DO NOT redefine)

Term Definition as Used in Dissertation
Structuration Giddens' concept of the recursive relationship between structure and agency
Duality of structure Structure as both medium and outcome of social practice
DSA Haggis' Dynamic Systems Abstraction — analytical framework for tracing emergent educational choices
Early overseas education Enrollment in US private high schools before university age
Transnational education Educational experiences that cross national boundaries
Resource mobilization The active, strategic deployment of allocative and authoritative resources by families
Knowledgeability Agents' practical and discursive awareness of structural conditions
Life trajectory The biographical path of an individual across time and social contexts

Chapter-Level RQ Map

Chapter Primary RQ Secondary RQ Status
CH1 N/A (Introduction) N/A FINAL
CH2 N/A (Literature Review) N/A FINAL
CH3 N/A (Theoretical Framework) N/A FINAL
CH4 N/A (Methodology) N/A FINAL
CH5 RQ1 FINAL
CH6 RQ2 RQ1 (continued) WIP (70%)
CH7 RQ3 PLANNED
CH8 N/A (Discussion/Conclusion) All RQs PLANNED


Reference: Mentor Feedback Patterns

Source file: references/mentor_patterns.md

Purpose

This file records the implicit academic standards and preferences extracted from the mentor's feedback on completed chapters. It is used by the Dr. Lois Weis (Academic Mentor) role to ensure new content meets the mentor's expectations.

Status

PENDING POPULATION: This file will be populated once Ryan uploads the mentor-annotated chapter files (CH[N]_Mentor_Comments_SNAPSHOT.docx) to the Google Drive project folder.


How to Update This File

When mentor-annotated files are available:

  1. Read each CH[N]_Mentor_Comments_SNAPSHOT.docx file.
  2. Extract patterns from the comments — NOT individual corrections, but recurring themes and implicit standards.
  3. Organize by category below.
  4. Update the "Status" above to "ACTIVE — Last updated: [date]".

Extracted Patterns (to be populated)

Writing Style Preferences

  • To be extracted from mentor comments

Theoretical Depth Requirements

  • To be extracted from mentor comments

Data-Theory Integration Standards

  • To be extracted from mentor comments

Structural/Organizational Preferences

  • To be extracted from mentor comments

Common Corrections (Recurring Issues to Avoid)

  • To be extracted from mentor comments

Phrases/Constructions the Mentor Dislikes

  • To be extracted from mentor comments

Phrases/Constructions the Mentor Prefers

  • To be extracted from mentor comments

Known Standards (from Project Instructions)

Based on the project setup, the following standards are already known:

  1. Writing style: Must emulate Lois Weis's academic writing style — critical, sociological, structurally clear, not descriptive.
  2. Theory-data integration: Every theoretical claim must be grounded in interview data. No floating theory.
  3. Analytical depth: Avoid "descriptive stacking." Every section must have a clear analytical argument.
  4. Framework adherence: All analysis must be embedded in Giddens' structuration theory + DSA. Additional frameworks only when justified.
  5. APA7 format: All citations must be in APA7 format.
  6. RQ alignment: Content must serve the chapter's RQ at a macro scale.
  7. Terminology consistency: Key terms must be used exactly as defined in CH1-4.


Template: Interactive UI

Source file: templates/interactive_ui.md

Purpose

Use this template whenever Ryan needs to specify his working context. Present this as a structured selection interface — do NOT ask open-ended questions.


Template: Working Status Update

Quick Status Check — Please select:

Current Chapter:

  • CH6 — Findings Part 2
  • CH7 — Discussion
  • CH8 — Conclusion/Discussion
  • Other: ___

Completion:

  • 0–25% (Early draft)
  • 25–50% (Developing)
  • 50–75% (Substantial draft)
  • 75–100% (Near complete)
  • 100% (Complete, in revision)

Working Mode:

  • GENERATE — Write new paragraph/section for me
  • EDIT — Polish/improve text I've written
  • TRANSLATE — Translate my Chinese text to academic English
  • REVIEW — Check logic, RQ alignment, consistency
  • THEORY — Deepen theoretical analysis

Current Section (optional): [Type section title or number, e.g., "6.2 Family Resource Mobilization"]

Task Description: [Paste your text here, or describe what you need]


Template: Literature Confirmation

When new literature is found and needs Ryan's confirmation before adding to Zotero:

New Literature Found — Please confirm:

I found the following reference(s) relevant to your current section. Please confirm which to add to your Zotero library:

# Author(s) Year Title Journal/Source Relevance
1 [Author] [Year] [Title] [Source] [Why relevant]
2 [Author] [Year] [Title] [Source] [Why relevant]
  • Add all to Zotero
  • Add selected (specify numbers): ___
  • Skip — do not add

Template: Intent Clarification

When Ryan's request is ambiguous, present this BEFORE generating any content:

Let me confirm my understanding before I proceed:

I understand you want me to: [State your interpretation of the task]

For the following section/chapter: [State which chapter/section]

Serving this purpose: [State the analytical purpose]

Is this correct?

  • Yes, proceed
  • No — [Ryan types correction here]
Usage Guidance
This skill's instructions expect local scripts, project folders, and external services (Zotero, Google Drive) but none of those are provided or declared. Before installing or enabling it: (1) ask the publisher for the missing scripts and templates or confirm they already exist in your environment; (2) confirm exactly how Zotero/Drive access will be authorized (which tokens or platform connectors will be used) and avoid supplying broad credentials unless you trust the author; (3) restrict autonomous invocation or require explicit confirmations for actions that read or upload sensitive interview or chapter files; (4) if you do not control the referenced /home/ubuntu paths, do not grant the agent access. Without those clarifications, the skill is internally inconsistent and could cause the agent to try to access unexpected local or external resources.
Capability Analysis
Type: OpenClaw Skill Name: dissertation-workflow-core Version: 1.0.0 The skill bundle is designed for a legitimate academic workflow. However, it instructs the AI agent to execute local Python scripts (`status_tracker.py`, `zotero_connector.py`) via shell commands in `SKILL.md`. Specifically, the `zotero_connector.py` script is called with parameters like `"query"` and `"doi_or_metadata"`, which are likely derived from user input or agent-generated content. If the agent does not properly sanitize these parameters before constructing the shell command, and if the Python scripts themselves are vulnerable to shell injection (e.g., using `os.system()` or `subprocess.run(..., shell=True)` without proper escaping), this creates a significant remote code execution vulnerability. This is a critical flaw that allows for potential attacks, classifying the skill as suspicious rather than benign, but without clear evidence of intentional malicious design.
Capability Assessment
Purpose & Capability
The skill's purpose (full-cycle dissertation support) is plausible, but the SKILL.md repeatedly instructs the agent to run local scripts and to load local knowledge-bases under /home/ubuntu/skills/dissertation-workflow-system-core/ and to interact with Zotero and Google Drive. The package contains only SKILL.md and declares no code, no install, and no required credentials — a mismatch between stated capabilities and what would actually be needed to perform them.
Instruction Scope
Instructions tell the agent to run specific Python scripts (e.g., scripts/status_tracker.py, scripts/zotero_connector.py), to read many local files and folders (references/rq_framework.md, references/mentor_patterns.md, 01_Completed_Chapters/, 03_Interview_Data/), to present templated interactive UIs (templates/interactive_ui.md), and to query external services (Google Drive, Google Scholar) via a 'search' tool — none of these files/tools exist in the provided bundle and no access/credentials are declared. The instructions also mandate ALWAYS reading this skill before any dissertation task, which centralizes control but does not resolve the missing dependencies.
Install Mechanism
There is no install spec (instruction-only), which normally reduces risk. However, the runtime steps assume local helper scripts and connectors will be present and executable. Because those scripts are not included and there is no install step to provision them, the instructions are effectively pointing at non-existent on-disk code — an incoherence that could lead the agent to attempt to access arbitrary local paths or external resources to satisfy the steps.
Credentials
The SKILL.md expects access to private data (interview transcripts, completed chapters) and to external services (Zotero, Google Drive, Google Scholar) but the skill declares no required environment variables, API keys, or auth mechanisms. That omission is disproportionate: integrating Zotero/Drive normally requires credentials or platform-provided connectors. The skill could therefore prompt the agent to seek credentials or attempt access to local files without explicit consent or declared requirements.
Persistence & Privilege
The skill does not request always:true and defaults to normal autonomous invocation. Autonomous invocation is standard; however, combined with the instruction set's broad scope (accessing local project folders and external libraries), it increases potential impact if the agent is allowed to act without per-action confirmations. The skill does not request modifying other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install dissertation-workflow-core
  3. After installation, invoke the skill by name or use /dissertation-workflow-core
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Dissertation Workflow System Core v1.0.0 - Initial release of the core workflow for full-cycle dissertation support in Sociology of Education. - Defines multi-agent virtual team roles and their coordination for writing, editing, translation, review, and theoretical analysis. - Implements structured working modes (GENERATE, EDIT, TRANSLATE, REVIEW, THEORY) with clear triggers and lead roles. - Introduces layered knowledge base: chapter constraints, interview data, mentor feedback, and literature integration. - Enforces strict alignment with research questions, theoretical frameworks (Giddens, DSA), and chapter consistency. - Outlines comprehensive quality control checklist and standardized output format for all dissertation tasks.
Metadata
Slug dissertation-workflow-core
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Dissertation Workflow Core?

Full-cycle dissertation writing support for Ryan Tang’s PhD, managing evidence, theory alignment, editing, translation, and quality control across all chapte... It is an AI Agent Skill for Claude Code / OpenClaw, with 400 downloads so far.

How do I install Dissertation Workflow Core?

Run "/install dissertation-workflow-core" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Dissertation Workflow Core free?

Yes, Dissertation Workflow Core is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Dissertation Workflow Core support?

Dissertation Workflow Core is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Dissertation Workflow Core?

It is built and maintained by Ryan Tang (@zhchelly-netizen); the current version is v1.0.0.

💬 Comments